Booking詳細API

Q: starsとratingの違いは何ですか？

starsは施設の公式の星評価（1〜5）で、ゲストの意見ではなく設備の水準を表します。ratingはゲストスコアの平均で、rating_scaleが示すとおりBookingでは10点満点です。rating_labelはこのスコアを「Wonderful」や「Very good」などの言葉で表します。設備が控えめなホテルでもゲストの満足度が高ければ5つ星ホテルを上回ることがあるため、2つは別々に分析してください。

Q: 特定の日付の料金はどのように取得しますか？

check_inとcheck_outの両方をYYYY-MM-DD形式の日付で送信してください。チェックアウト日はチェックイン日より後にする必要があります。どちらか一方のみの場合、宿泊日は適用されません。priceは単純な数値で返され、通貨コードはcurrencyに入ります。currencyパラメータでは、記載されたコードの中から表示通貨を選択できます。日付範囲にわたって客室タイプごとの日別料金を取得するには、Booking Pricesを使用してください。

POST

APIの稼働状況

24時間の稼働状況: 正常
24時間の平均応答時間: —

良好／正常
利用可能
制限あり
ほぼ停止

正常

過去24時間

過去30日間

/hotel/ページのリンクから、Booking.comの施設1件の情報を取得します。説明、施設タイプ、公式の星評価、カテゴリ別評価を含むゲストスコア、設備、住所、提示料金が含まれます。公式のstarsとゲストのratingは別の指標です。日付を指定しても料金は確定しません。

Booking Detailsは、ページのリンクで指定したBooking上の1つの施設を取得し、施設情報を返します。名前と種別、説明、公式の星評価、ゲストスコアとその評価ラベル・レビュー数、住所と座標、チェーンブランド、朝食の条件、画像、料金と通貨が含まれます。ホテルの契約担当チームや収益管理チームは、交渉相手や競合となる施設を把握するために利用し、旅行サービスはホテルページに一貫したデータを掲載するために利用しています。

2つの品質指標は区別して扱ってください。starsは1〜5の公式の星評価です。ratingはゲストスコアで、Bookingでは10点満点で付けられ、rating_labelはそれに対応する言葉です。独立系ホテルの場合、hotel_chainはnullになります。料金は日付によって変わるため、特定の宿泊の料金を調べるにはcheck_inとcheck_outの両方を渡し、保存するすべてのpriceと合わせてcheck_in_dateとcheck_out_dateも保存してください。langには、engb（デフォルト）、enus、zhcnなどのBookingのロケールコードを指定します。単なるenやzhは使用できません。

料金は1,000リクエストあたり$1.39（1回あたり$0.001389）です。失敗した呼び出しと空の結果には課金されません。同期処理です。時間のかかるジョブでは、ボディに"mode": "async"を追加し、job_idを取得してポーリングしてください。

AIプロンプト

EveryInfraのBooking 詳細エンドポイント（booking/profile）を使ったデータ収集スクリプトの作成を手伝ってください。

エンドポイントの仕組み：
- リクエスト：ヘッダーにAuthorization: Bearer <API key>を指定して、https://api.everyinfra.com/api/v1/socialにPOSTします。APIキーは環境変数EVERYINFRA_API_KEYから読み込み、ハードコードしないでください。
- リクエストボディでplatformにbooking、actionにprofileを指定し、パラメータはparamsの中に入れます。
- 必須パラメータ：
  - url: 単一の施設ページの完全なURLを指定します。/hotel/形式のパスを推奨します。profileでは詳細の取得、reviewsでは施設のレビューの取得、pricesでは客室料金の確認に使用します。目的地の検索URLには対応していません。
- 任意パラメータ：
  - check_in: チェックイン日をYYYY-MM-DD形式で指定します。searchおよびprofileアクションで滞在日程を送信するには、check_inとcheck_outの両方が必要です。pricesでは、start_dateを省略した場合に開始日として扱われます。予約は作成されません。
  - check_out: チェックアウト日をYYYY-MM-DD形式で指定します。check_inより後の日付で、check_inと一緒に指定する必要があります。check_outのみを指定しても、searchやprofileアクションに滞在期間は渡されません。
  - currency: 宿泊施設の価格表示に使う通貨を指定します。デフォルトはUSDです。searchおよびprofileアクションでは記載された小文字のコードを、pricesでは大文字3文字のコードを受け付けます。このパラメータはEveryInfraのAPI課金には影響しません。（指定可能な値：aed / ars / aud / azn / bgn / bhd / brl / cad）
  - lang: 宿泊施設ページの表示言語を指定します。デフォルトはイギリス英語です。イギリス英語またはアメリカ英語にはengbまたはenus、簡体字中国語または繁体字中国語にはzhcnまたはzhtwを指定します（汎用のenやzhは渡さないでください）。このパラメータはレビュー本文を翻訳しません。（指定可能な値：ar / bg / ca / cs / da / de / el / engb）
- 1つのオブジェクトを返します。主なフィールド: id、name、type、url、text、stars（ホテルの星ランク（1〜5））、rating、rating_scale、rating_label（スコアから算出される評価のテキストラベル（例：Wonderful、Very g…）、review_count、price、currency。フィールドは全部で25個です。一覧はhttps://api.everyinfra.com/api/v1/social/catalog?platform=bookingを参照してください。.
- リクエストボディの例：
{
  "platform": "booking",
  "action": "profile",
  "params": {
    "url": "https://www.booking.com/hotel/jp/park-hyatt-tokyo.html"
  }
}
- 料金：1,000リクエストあたり$1.39。失敗時および結果が空の場合は課金されません。
- 対象が数十〜数百件ある場合は、ボディに"mode": "async"を追加します。すぐにjob_idが返されるので、GET https://api.everyinfra.com/api/v1/jobs/{job_id}をポーリングして結果を取得します。
- 422の場合は、エラーに含まれる推奨パラメータ名と指定可能な値を使ってリクエストを修正します。429または503の場合は、Retry-Afterの指定に従って待ってから再試行します。

コードを書く前に、必要な対象とその件数、必要なフィールド、希望する出力形式を私に質問してください。そのうえで、計画と概算費用を私に確認してください。

リクエストパラメータ

名前	場所	型	必須	デフォルト	説明
`Authorization`	header	`string`	はい	-	Bearerの後にAPIキーを続けます。APIキーはコンソールで作成してください。URLやコードリポジトリには絶対に含めないでください。
`platform`	body	`string`	はい	`booking`	プラットフォームの識別子です。値は固定です。
`action`	body	`string`	はい	`profile`	機能の識別子です。値は固定です。
`url`	body.params	`string`	はい	-	単一の施設ページの完全なURLを指定します。/hotel/形式のパスを推奨します。profileでは詳細の取得、reviewsでは施設のレビューの取得、pricesでは客室料金の確認に使用します。目的地の検索URLには対応していません。
`check_in`	body.params	`date`	いいえ	-	チェックイン日をYYYY-MM-DD形式で指定します。searchおよびprofileアクションで滞在日程を送信するには、check_inとcheck_outの両方が必要です。pricesでは、start_dateを省略した場合に開始日として扱われます。予約は作成されません。
`check_out`	body.params	`date`	いいえ	-	チェックアウト日をYYYY-MM-DD形式で指定します。check_inより後の日付で、check_inと一緒に指定する必要があります。check_outのみを指定しても、searchやprofileアクションに滞在期間は渡されません。
`currency`	body.params	`string (enum)`	いいえ	-	宿泊施設の価格表示に使う通貨を指定します。デフォルトはUSDです。searchおよびprofileアクションでは記載された小文字のコードを、pricesでは大文字3文字のコードを受け付けます。このパラメータはEveryInfraのAPI課金には影響しません。指定可能な値`aedarsaudaznbgnbhdbrlcadchfclpcnycopczkdkkegpeurfjdgbpgelhkdhufidrilsinrjodjpykrwkwdkztmdlmxnmyrnadnoknzdomrplnqarronrubsarseksgdthbtrytwduahusdxofzar`
`lang`	body.params	`string (enum)`	いいえ	-	宿泊施設ページの表示言語を指定します。デフォルトはイギリス英語です。イギリス英語またはアメリカ英語にはengbまたはenus、簡体字中国語または繁体字中国語にはzhcnまたはzhtwを指定します（汎用のenやzhは渡さないでください）。このパラメータはレビュー本文を翻訳しません。指定可能な値`arbgcacsdadeelengbenusesesaretfifrhehrhuidisitjakoltlvmsnlnoplptbrptptroruskslsrsvthtltrukvizhcnzhtw`

コードサンプル

bash

curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "booking",
  "action": "profile",
  "params": {
    "url": "https://www.booking.com/hotel/jp/park-hyatt-tokyo.html"
  }
}'

OpenAPI定義（JSON）サンプルは環境変数EVERYINFRA_API_KEYからAPIキーを読み込みます。コピーしたコードにAPIキーが含まれることはありません。

レスポンス例

実際のレスポンス

September 26, 2026 at 08:56（UTC）に、上のコードサンプルのパラメータでこのAPIを呼び出して取得しました。resultsとcountはその呼び出しの実際のレスポンスから個人情報（名前、ハンドル、アバター、プロフィールリンク、連絡先）を削除したものです。id、billing、quotaは呼び出しごとに異なるため、構造のみを示しています。

json

{
  "id": "req_…",
  "platform": "booking",
  "action": "profile",
  "results": {
    "id": 179810,
    "name": "Park Hyatt Tokyo",
    "type": "hotel",
    "url": "https://www.booking.com/hotel/jp/park-hyatt-tokyo.en-gb.html",
    "text": "Get the celebrity treatment with world-class service at Park Hyatt TokyoPark Hyatt Tokyo welcomes you home, thoughtfully crafting each moment with intuitive care to ensure every stay feels personally tailored. Located in Shinjuku, west Tokyo, Park Hyatt Tokyo occupies the 39th to…",
    "stars": 5,
    "rating": 9.2,
    "review_count": 128,
    "breakfast": "Buffet",
    "address": "Tokyo-to, Tokyo, Shinjuku-ku, Nishishinjuku 3-7-1-2, Japan",
    "city": "Tokyo",
    "country": "jp",
    "latitude": "35.684871080031755",
    "longitude": "139.69104677438736",
    "image_url": "https://cf.bstatic.com/xdata/images/hotel/max1024x768/909678791.jpg?k=bd70c52af1180cbfa82618a22e8b6db4b822c98835618ea713199b0d4636b55f&o=",
    "platform": "booking",
    "category_ratings": [
      {
        "name": "Location",
        "score": 9.1
      },
      {
        "name": "Cleanliness",
        "score": 9.7
      },
      {
        "name": "Value for money",
        "score": 8.5
      }
    ],
    "image_urls": [
      "https://cf.bstatic.com/xdata/images/hotel/max1024x768/909678791.jpg?k=bd70c52af1180cbfa82618a22e8b6db4b822c98835618ea713199b0d4636b55f&o=&hp=1",
      "https://cf.bstatic.com/xdata/images/hotel/max1024x768/909677947.jpg?k=0132e551e1b3f34b69767d6416d778dee86bfd324025f3d0a6d39a2b21e005ca&o=&hp=1",
      "https://cf.bstatic.com/xdata/images/hotel/max1024x768/110318598.jpg?k=180b52ab1b8a3cdda7a6a014c2068e381bcfa4dc8573036a19ce57241e6b1018&o=&hp=1"
    ],
    "facilities": [
      "4 restaurants",
      "Parking",
      "Private bathroom"
    ],
    "rating_scale": 10
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

レスポンスフィールド

業務データはresultsに含まれます。この表はレコードに含まれうるフィールドの一覧です。プラットフォームに表示されない値を作り出すことはありません。

フィールド	意味
`id`	プラットフォーム上でのレコードの一意なIDです。一意性は1つのプラットフォーム内に限られ、プラットフォームが異なるとIDが重複する場合があります。
`name`	対象そのものの名前です（アカウント・商品・ビジネス系の機能で使用）。
`type`	レコードの種類です。値は機能によって異なります（例：video / image / text）。
`url`	プラットフォーム上のレコードへのリンクです。
`text`	HTMLを除去した本文です。省略されることなく全文が返されます（一部のプラットフォームでは一覧結果自体に抜粋しか含まれません。その場合は各プラットフォームのフィールドの注記に記載しています）。
`stars`	ホテルの星ランク（1〜5）。施設の設備に対する公式な格付けです。ratingのゲスト評価とは別物です。
`rating`	評価です。スケールはプラットフォームによって異なります。最大値は同じ行のrating_scaleで示されます（通常は5。Booking、Douban、iQIYI、NAVERは10）。プラットフォーム間で比較する前にrating_scaleで換算してください。換算しないと比較結果が逆転することがあります。
`rating_scale`	同じ行のratingの最大値です。5段階評価では5、10点満点では10になります。行にratingがある場合のみ含まれます。
`rating_label`	スコアから算出される評価のテキストラベル（例：Wonderful、Very good）。
`review_count`	レビュー数です（商品・ビジネス系の機能で使用）。nullは非公開を示し、0ではありません。
`price`	通貨記号を含まない数値で表した価格です。通貨についてはcurrencyを参照してください。
`currency`	価格の通貨コードです（例：CNY、USD）。priceフィールドが存在してもcurrencyがnullの場合は、通貨を推測しないでください。
`breakfast`	朝食に関する注記（宿泊料金に含まれる、含まれない、または追加料金）。
`hotel_chain`	施設が属するホテルチェーン。独立系ホテルの場合はnullです。
`check_in_date`	この検索で使用したチェックイン日。
`check_out_date`	この検索で使用したチェックアウト日。
`address`	住所全体です。取得したまま返します。
`city`	プラットフォームで使用されている言語の都市名です。正規化されていません。
`country`	国または地域です。プラットフォームによって正式名称またはISOコードで返され、正規化はしていません。
`latitude`	緯度。
`longitude`	経度。
`image_url`	画像のリンクです。複数の画像を返す機能では、image_urls配列が返される場合があります。
`platform`	取得元プラットフォームの識別子で、リクエストのplatformと同じです（例：xiaohongshu、tiktok）。
`category_ratings`	カテゴリ別スコア。それぞれ名前（清潔さ、立地など）とスコアを持ちます。該当がない場合は含まれません。
`image_urls`	画像リンクの配列で、プラットフォームでの表示順に並びます。画像がない場合は含まれません。
`facilities`	施設・サービス名の一覧。ページ上のグループ順に並びます。該当がない場合は含まれません。

FAQ

`url`にはどのBookingリンクを渡せばよいですか？

単一の施設ページの完全なリンクを渡してください。https://www.booking.com/hotel/jp/park-hyatt-tokyo.htmlのような/hotel/パス上のリンクを推奨します。目的地や検索結果のページには複数の施設が掲載されており、1つの施設を特定できません。同じ施設リンクは、ゲストレビューを取得するBooking Reviewsや、客室料金を取得するBooking Pricesでも使用できます。

`stars`と`rating`の違いは何ですか？

starsは施設の公式の星評価（1〜5）で、ゲストの意見ではなく設備の水準を表します。ratingはゲストスコアの平均で、rating_scaleが示すとおりBookingでは10点満点です。rating_labelはこのスコアを「Wonderful」や「Very good」などの言葉で表します。設備が控えめなホテルでもゲストの満足度が高ければ5つ星ホテルを上回ることがあるため、2つは別々に分析してください。

特定の日付の料金はどのように取得しますか？

check_inとcheck_outの両方をYYYY-MM-DD形式の日付で送信してください。チェックアウト日はチェックイン日より後にする必要があります。どちらか一方のみの場合、宿泊日は適用されません。priceは単純な数値で返され、通貨コードはcurrencyに入ります。currencyパラメータでは、記載されたコードの中から表示通貨を選択できます。日付範囲にわたって客室タイプごとの日別料金を取得するには、Booking Pricesを使用してください。

エラーと課金

401: キーが未指定か無効です。
402: 残高が不足しています。先にチャージしてください。
422: パラメータ名または値が無効です。エラーに含まれる候補を参考に修正してください。課金はされません。
429: 1分あたりのリクエスト上限に達しました。Retry-Afterの指定に従って待ってから再試行してください。
503: 処理を完了できませんでした。保留中の請求額は残高に戻されます。結果が不明な場合は、再試行する前に確認してください。
200（空）: データがありません。課金はされません。

エラー

公式リファレンス

対象と用語の確認にのみ使用しています。プラットフォームによるEveryInfraの承認や推奨を意味するものではありません。

Booking：施設ページの星評価とクチコミスコア ↗
Bookingでは、宿泊施設の星評価、ゲストのクチコミスコア、品質評価を区別しています。profileアクションは、URLで指定した公開施設ページを1件読み取ります。この出典は返される評価の用語を説明するものであり、評価をリクエストのフィルターにしたり、予約を保証したりするものではありません。
確認日：2026-09-04