Skip to content
Docs

Jalan

Hotels and ryokan in Japan.Every plan and room at one Jalan hotel for a stay. Prices are JPY for one room and every adult, consumption tax and service charge included. A sale keeps the struck-through total.
Look up by
Hotel number (389255 or yad389255) or hotel URL
Coverage
Japan, JPY
Cost
From 1 credit a call; failed and empty calls are free
Endpoints
2 endpoints
  • Prices
  • Rooms and rate plans

Endpoints

Example

Jalan plans, with POST /v1/ota/jalan. Set SCRAPERCOMPANY_API_KEY to your key and run it; the full parameter list is in the API reference.

curl -X POST "https://api.scrapercompany.com/v1/ota/jalan" \
  -H "x-api-key: $SCRAPERCOMPANY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "check_in": "2026-12-25",
    "hotel_no": "389255"
  }'
200 response
{
  "search_parameters": {
    "engine": "jalan_property",
    "hotel_no": "389255",
    "check_in_date": "2027-02-24",
    "check_out_date": "2027-02-26",
    "adults": 2
  },
  "property": {
    "property_id": "389255",
    "name": "スーパーホテルPremier銀座 天然温泉 奥湯河原の湯",
    "price_per_night": 44650,
    "total_tax_included": 89300,
    "currency": "JPY",
    "sold_out": false,
    "availability": "available",
    "is_soldout": false,
    "provenance": {
      "schema_version": 1,
      "observation_id": "rateobs_0123456789abcdef0123456789abcdef",
      "collection_id": "ratecol_0123456789abcdef0123456789abcdef",
      "observed_at": "2026-08-07T01:23:45.678Z",
      "source": "jalan",
      "source_kind": "ota_rate_plan",
      "source_property_id": "389255",
      "requested_currency": "JPY",
      "returned_currency": "JPY",
      "price_basis": "consumption_tax_and_service_included",
      "derivation": "normalized_upstream"
    },
    "rooms": [
      {
        "name": "【素泊まり】レディース ルーム【女性専用アメニティ完備】",
        "room_code": "0488389",
        "room_type": "ダブル",
        "available": true,
        "cheapest_price": 44650,
        "rate_plans": [
          {
            "plan_code": "03379367",
            "room_code": "0488389",
            "name": "【じゃらんのお得な10日間】【素泊まり】厳選ベストレートプラン☆天然温泉付き",
            "price": 45590,
            "total_tax_included": 91180,
            "price_per_adult": 22320,
            "currency": "JPY",
            "meal": "食事なし",
            "remaining": 1,
            "points": 1822,
            "labels": [
              "終了間近"
            ],
            "rate_code": "03379367",
            "rate_category": "unknown",
            "meal_plan": "room_only",
            "rate_code_scope": "property",
            "provenance": {
              "schema_version": 1,
              "observation_id": "rateobs_0123456789abcdef0123456789abcdef",
              "collection_id": "ratecol_0123456789abcdef0123456789abcdef",
              "observed_at": "2026-08-07T01:23:45.678Z",
              "source": "jalan",
              "source_kind": "ota_rate_plan",
              "source_property_id": "389255",
              "requested_currency": "JPY",
              "returned_currency": "JPY",
              "price_basis": "consumption_tax_and_service_included",
              "derivation": "normalized_upstream"
            }
          }
        ]
      }
    ]
  },
  "meta": {
    "source": "jalan",
    "nights": 2,
    "adults": 2,
    "elapsed_s": 1.19,
    "total_rate_plans": 54,
    "comparable_across_markets": false,
    "notes": "JPY only. Totals include consumption tax and service charge; local accommodation and bathing taxes are paid at the hotel and are never included."
  }
}
Arrays are shortened to their first item.

Try it on your key

Good to know

  • Local accommodation and bathing taxes are never included.
  • Jalan pauses overnight for maintenance (Japan time); calls then answer 503 with Retry-After and are not charged.

The domestic sites travellers in Japan and Korea book on, priced in JPY and KRW.

Or browse every data source.

Questions about this page?

Send the page link and your question, and the team will answer.

Email support