Skip to main content
POST
/
api
/
rakuten_travel
/
hotels
/
search
/rakuten_travel/hotels/search
curl --request POST \
  --url https://api.anysite.io/api/rakuten_travel/hotels/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 2,
  "timeout": 300,
  "sort": "recommended"
}
'
[
  {
    "id": "<string>",
    "name": "<string>",
    "url": "<string>",
    "@type": "@rakuten_travel_search_hotel",
    "image": "<string>",
    "description": "<string>",
    "rating": 123,
    "review_count": 123,
    "price": 123,
    "price_with_tax": 123,
    "currency": "JPY",
    "access": "<string>",
    "features": []
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
prefecture
enum<string>
required

Japanese prefecture (romaji) to list hotels in

Available options:
hokkaido,
aomori,
iwate,
miyagi,
akita,
yamagata,
fukushima,
ibaraki,
tochigi,
gunma,
saitama,
chiba,
tokyo,
kanagawa,
niigata,
toyama,
ishikawa,
fukui,
yamanashi,
nagano,
gifu,
shizuoka,
aichi,
mie,
shiga,
kyoto,
osaka,
hyogo,
nara,
wakayama,
tottori,
shimane,
okayama,
hiroshima,
yamaguchi,
tokushima,
kagawa,
ehime,
kochi,
fukuoka,
saga,
nagasaki,
kumamoto,
oita,
miyazaki,
kagoshima,
okinawa
Examples:

"tokyo"

"osaka"

"hokkaido"

count
integer
required

Max number of results to return

Required range: x >= 1
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
sort
enum<string>
default:recommended

Sort order. Default: recommended

Available options:
recommended,
price_low,
price_high,
rating

Response

Successful Response

id
string
required
name
string
required
url
string
required
@type
string
default:@rakuten_travel_search_hotel
image
string | null
description
string | null
rating
number | null
review_count
integer | null
price
integer | null
price_with_tax
integer | null
currency
string
default:JPY
access
string | null
features
string[]