/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": "<string>",
"checkin": "<string>",
"nights": 1,
"adults": 2,
"rooms": 1,
"budget_min": 1,
"budget_max": 1,
"sort": "recommended"
}
'import requests
url = "https://api.anysite.io/api/jalan/hotels/search"
payload = {
"prefecture": "<string>",
"large_area": "<string>",
"count": 2,
"timeout": 300,
"small_area": "<string>",
"checkin": "<string>",
"nights": 1,
"adults": 2,
"rooms": 1,
"budget_min": 1,
"budget_max": 1,
"sort": "recommended"
}
headers = {
"access-token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'access-token': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
prefecture: '<string>',
large_area: '<string>',
count: 2,
timeout: 300,
small_area: '<string>',
checkin: '<string>',
nights: 1,
adults: 2,
rooms: 1,
budget_min: 1,
budget_max: 1,
sort: 'recommended'
})
};
fetch('https://api.anysite.io/api/jalan/hotels/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.anysite.io/api/jalan/hotels/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'prefecture' => '<string>',
'large_area' => '<string>',
'count' => 2,
'timeout' => 300,
'small_area' => '<string>',
'checkin' => '<string>',
'nights' => 1,
'adults' => 2,
'rooms' => 1,
'budget_min' => 1,
'budget_max' => 1,
'sort' => 'recommended'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"access-token: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.anysite.io/api/jalan/hotels/search"
payload := strings.NewReader("{\n \"prefecture\": \"<string>\",\n \"large_area\": \"<string>\",\n \"count\": 2,\n \"timeout\": 300,\n \"small_area\": \"<string>\",\n \"checkin\": \"<string>\",\n \"nights\": 1,\n \"adults\": 2,\n \"rooms\": 1,\n \"budget_min\": 1,\n \"budget_max\": 1,\n \"sort\": \"recommended\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("access-token", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.anysite.io/api/jalan/hotels/search")
.header("access-token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"prefecture\": \"<string>\",\n \"large_area\": \"<string>\",\n \"count\": 2,\n \"timeout\": 300,\n \"small_area\": \"<string>\",\n \"checkin\": \"<string>\",\n \"nights\": 1,\n \"adults\": 2,\n \"rooms\": 1,\n \"budget_min\": 1,\n \"budget_max\": 1,\n \"sort\": \"recommended\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.anysite.io/api/jalan/hotels/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["access-token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"prefecture\": \"<string>\",\n \"large_area\": \"<string>\",\n \"count\": 2,\n \"timeout\": 300,\n \"small_area\": \"<string>\",\n \"checkin\": \"<string>\",\n \"nights\": 1,\n \"adults\": 2,\n \"rooms\": 1,\n \"budget_min\": 1,\n \"budget_max\": 1,\n \"sort\": \"recommended\"\n}"
response = http.request(request)
puts response.read_body[
{
"id": "<string>",
"url": "<string>",
"name": "<string>",
"@type": "JalanHotelSearchResult",
"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": [],
"access": "<string>",
"image": "<string>",
"images": [],
"plan_count": 123
}
]{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}/jalan
/jalan/hotels/search
Search Jalan (じゃらん) hotels and ryokan by area (prefecture / large-area / small-area codes), with optional stay dates, party size, nightly budget and ordering. Returns a list of hotel cards with name, catch phrase, area, labels, lowest total and per-person price for the stay, overall rating and review count, top-rated aspects, description, access directions, photos and the number of available plans.
Price: 20 credits per 30 results
⚠️ Common errors: 412: Area not found (well-formed codes but the prefecture/large-area does not exist on Jalan)
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": "<string>",
"checkin": "<string>",
"nights": 1,
"adults": 2,
"rooms": 1,
"budget_min": 1,
"budget_max": 1,
"sort": "recommended"
}
'import requests
url = "https://api.anysite.io/api/jalan/hotels/search"
payload = {
"prefecture": "<string>",
"large_area": "<string>",
"count": 2,
"timeout": 300,
"small_area": "<string>",
"checkin": "<string>",
"nights": 1,
"adults": 2,
"rooms": 1,
"budget_min": 1,
"budget_max": 1,
"sort": "recommended"
}
headers = {
"access-token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'access-token': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
prefecture: '<string>',
large_area: '<string>',
count: 2,
timeout: 300,
small_area: '<string>',
checkin: '<string>',
nights: 1,
adults: 2,
rooms: 1,
budget_min: 1,
budget_max: 1,
sort: 'recommended'
})
};
fetch('https://api.anysite.io/api/jalan/hotels/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.anysite.io/api/jalan/hotels/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'prefecture' => '<string>',
'large_area' => '<string>',
'count' => 2,
'timeout' => 300,
'small_area' => '<string>',
'checkin' => '<string>',
'nights' => 1,
'adults' => 2,
'rooms' => 1,
'budget_min' => 1,
'budget_max' => 1,
'sort' => 'recommended'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"access-token: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.anysite.io/api/jalan/hotels/search"
payload := strings.NewReader("{\n \"prefecture\": \"<string>\",\n \"large_area\": \"<string>\",\n \"count\": 2,\n \"timeout\": 300,\n \"small_area\": \"<string>\",\n \"checkin\": \"<string>\",\n \"nights\": 1,\n \"adults\": 2,\n \"rooms\": 1,\n \"budget_min\": 1,\n \"budget_max\": 1,\n \"sort\": \"recommended\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("access-token", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.anysite.io/api/jalan/hotels/search")
.header("access-token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"prefecture\": \"<string>\",\n \"large_area\": \"<string>\",\n \"count\": 2,\n \"timeout\": 300,\n \"small_area\": \"<string>\",\n \"checkin\": \"<string>\",\n \"nights\": 1,\n \"adults\": 2,\n \"rooms\": 1,\n \"budget_min\": 1,\n \"budget_max\": 1,\n \"sort\": \"recommended\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.anysite.io/api/jalan/hotels/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["access-token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"prefecture\": \"<string>\",\n \"large_area\": \"<string>\",\n \"count\": 2,\n \"timeout\": 300,\n \"small_area\": \"<string>\",\n \"checkin\": \"<string>\",\n \"nights\": 1,\n \"adults\": 2,\n \"rooms\": 1,\n \"budget_min\": 1,\n \"budget_max\": 1,\n \"sort\": \"recommended\"\n}"
response = http.request(request)
puts response.read_body[
{
"id": "<string>",
"url": "<string>",
"name": "<string>",
"@type": "JalanHotelSearchResult",
"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": [],
"access": "<string>",
"image": "<string>",
"images": [],
"plan_count": 123
}
]{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Authorizations
API token from the dashboard
Headers
Body
application/json
Required range:
x >= 1Required range:
20 <= x <= 1500Required range:
x >= 1Required range:
x >= 1Required range:
x >= 1Required range:
x >= 0Required range:
x >= 0Available options:
recommended, price_low, area Response
Successful Response