Skip to main content
POST
/
api
/
jalan
/
hotels
/
search
/jalan/hotels/search
curl --request POST \
  --url https://api.anysite.io/api/jalan/hotels/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "prefecture": "<string>",
  "large_area": "<string>",
  "count": 2,
  "timeout": 300,
  "small_area": "137102",
  "checkin": "2026-07-10",
  "nights": 1,
  "adults": 2,
  "rooms": 1,
  "budget_min": 1,
  "budget_max": 1,
  "sort": "recommended"
}
'
[
  {
    "id": "<string>",
    "url": "<string>",
    "name": "<string>",
    "@type": "@jalan_hotel_search_result",
    "catch_phrase": "<string>",
    "region": "<string>",
    "area": "<string>",
    "labels": [],
    "is_high_class": false,
    "total_price": 123,
    "per_person_price": 123,
    "rating": 123,
    "review_count": 123,
    "highly_rated": [],
    "description": "<string>",
    "access": "<string>",
    "image": "<string>",
    "images": [],
    "plan_count": 123
  }
]

Authorizations

​
access-token
string
header
required

API token from the dashboard

Headers

​
access-token
string
required

Body

application/json
​
prefecture
string
required

Jalan prefecture area code (6 digits), e.g. 130000 for Tokyo

Example:

"130000"

​
large_area
string
required

Jalan large-area code (6 digits) within the prefecture

Example:

"137100"

​
count
integer
required

Number of hotels to return

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

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
​
small_area
string | null

Optional Jalan small-area code (6 digits) to narrow within the large area

Example:

"137102"

​
checkin
string | null

Check-in date (YYYY-MM-DD). When omitted, the lowest available rates are returned

Example:

"2026-07-10"

​
nights
integer
default:1

Number of nights

Required range: x >= 1
​
adults
integer
default:2

Number of adults

Required range: x >= 1
​
rooms
integer
default:1

Number of rooms

Required range: x >= 1
​
budget_min
integer | null

Minimum price per room per night in JPY

Required range: x >= 0
​
budget_max
integer | null

Maximum price per room per night in JPY

Required range: x >= 0
​
sort
enum<string>
default:recommended

Result ordering

Available options:
recommended,
price_low,
area

Response

Successful Response

​
id
string
required
​
url
string
required
​
name
string
required
​
@type
string
default:@jalan_hotel_search_result
​
catch_phrase
string | null
​
region
string | null
​
area
string | null
​
labels
string[]
​
is_high_class
boolean
default:false
​
total_price
integer | null
​
per_person_price
integer | null
​
rating
number | null
​
review_count
integer | null
​
highly_rated
string[]
​
description
string | null
​
access
string | null
​
image
string | null
​
images
string[]
​
plan_count
integer | null