プラットフォームの稼働状況
- 24時間の稼働状況
- 正常
過去30日間
利用可能な機能
Bookingの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
検索search | 目的地を指定して、Booking.comでホテル、アパートメントなどの宿泊施設を検索します。公式の星評価、ゲストスコア、料金、朝食の条件、チェーン、所在地を取得できます。日付はcheck_inとcheck_outをペアで送信してください。料金は表示時点のもので、予約が完了するまで保証されません。 | 1,000リクエストあたり$1.39 | 正常 |
詳細profile | /hotel/ページのリンクから、Booking.comの施設1件の情報を取得します。説明、施設タイプ、公式の星評価、カテゴリ別評価を含むゲストスコア、設備、住所、提示料金が含まれます。公式のstarsとゲストのratingは別の指標です。日付を指定しても料金は確定しません。 | 1,000リクエストあたり$1.39 | 正常 |
レビューreviews | Booking.comの施設に寄せられたゲストレビューを収集します。良かった点と悪かった点のテキストは別々に保持され、スコア、宿泊月、旅行者タイプ、客室、ホテルからの返信も含まれます。どちらか一方が空の場合もあり、1回の取得ですべてのレビューが含まれるとは限りません。 | 1,000リクエストあたり$1.39 | 正常 |
価格prices | Booking.comの施設の客室料金を日ごとに比較します。客室タイプ、元の料金と現在の料金、税金、返金の可否、食事プラン、残室数を取得できます。daysの期間はデフォルトで7日、最大30日です。各行のcheck_inとcheck_outはホテルの毎日のチェックイン・チェックアウト時刻で、指定した日付ではありません。 | 1,000リクエストあたり$1.39 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
Bookingの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
search検索 目的地を指定して、Booking.comでホテル、アパートメントなどの宿泊施設を検索します。公式の星評価、ゲストスコア、料金、朝食の条件、チェーン、所在地を取得できます。日付は | keyword | check_in, check_out, currency, lang, min_price, property_type, sort, star_rating | Sync配信 | カタログ値：defaultLimit=10、maxLimit=30。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · name · type · url · text · stars · rating · rating_scale · rating_label · review_count · price · currency · breakfast · hotel_chain · check_in_date · check_out_date · address · city · country · latitude · longitude · image_url · platform · category_ratings · image_urls · facilities |
profile詳細 /hotel/ページのリンクから、Booking.comの施設1件の情報を取得します。説明、施設タイプ、公式の星評価、カテゴリ別評価を含むゲストスコア、設備、住所、提示料金が含まれます。公式の | url | check_in, check_out, currency, lang | Sync配信 | — | 1,000リクエストあたり$1.39 | id · name · type · url · text · stars · rating · rating_scale · rating_label · review_count · price · currency · breakfast · hotel_chain · check_in_date · check_out_date · address · city · country · latitude · longitude · image_url · platform · category_ratings · image_urls · facilities |
reviewsレビュー Booking.comの施設に寄せられたゲストレビューを収集します。良かった点と悪かった点のテキストは別々に保持され、スコア、宿泊月、旅行者タイプ、客室、ホテルからの返信も含まれます。どちらか一方が空の場合もあり、1回の取得ですべてのレビューが含まれるとは限りません。 | url | — | Sync配信 | カタログ値：defaultLimit=20、maxLimit=100。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · title · text_positive · text_negative · rating · rating_scale · posted_at · stay_date · author_name · author_country · traveler_type · room_name · nights · language · owner_response · platform |
prices価格 Booking.comの施設の客室料金を日ごとに比較します。客室タイプ、元の料金と現在の料金、税金、返金の可否、食事プラン、残室数を取得できます。 | url | adults, check_in, currency, days, rooms, start_date | Sync配信 | — | 1,000リクエストあたり$1.39 | id · url · hotel_name · room_name · check_in · check_out · price · original_price · discount_percent · currency · taxes_included · is_sold_out · availability_status · min_stay · bed_type · max_guests · room_size_sqm · meal_plan · is_breakfast_included · is_refundable · rate_options_count · platform · rooms_left · room_view |
Bookingのsearchのパラメータはそれぞれどういう意味ですか？
目的地を指定して、Booking.comでホテル、アパートメントなどの宿泊施設を検索します。公式の星評価、ゲストスコア、料金、朝食の条件、チェーン、所在地を取得できます。日付はcheck_inとcheck_outをペアで送信してください。料金は表示時点のもので、予約が完了するまで保証されません。
keyword必須- 施設の目的地名を指定します（例：Amsterdam）。searchアクションでホテル、アパートメントなどの宿泊施設を検索する際に使用します。フライト、観光スポット、レビューのキーワードには使用しません。
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課金には影響しません。指定可能な値:
aedarsaudaznbgnbhdbrlcadchfclpcnycopczkdkkegpeurfjdgbpgelhkdhufidrilsinrjodjpykrwkwdkztmdlmxnmyrnadnoknzdomrplnqarronrubsarseksgdthbtrytwduahusdxofzar lang任意- 宿泊施設ページの表示言語を指定します。デフォルトはイギリス英語です。イギリス英語またはアメリカ英語にはengbまたはenus、簡体字中国語または繁体字中国語にはzhcnまたはzhtwを指定します（汎用のenやzhは渡さないでください）。このパラメータはレビュー本文を翻訳しません。指定可能な値:
arbgcacsdadeelengbenusesesaretfifrhehrhuidisitjakoltlvmsnlnoplptbrptptroruskslsrsvthtltrukvizhcnzhtw min_price任意- 1泊あたりの料金範囲を表す文字列で施設を絞り込みます。単一の最低額ではありません（例：範囲指定は100-150、100以上は100+）。通貨はcurrencyパラメータで指定します。滞在全体の合計料金には対応していません。
property_type任意- 宿泊施設のカテゴリで検索結果を絞り込みます。値は大文字・小文字とスペースを含めてそのまま指定します（例：Hotels、Apartments、Hostels、Guest houses、Homestays、Bed and breakfasts、Holiday homes、Boats、Villas、Motels、Resorts、Holiday parks、Campsites、Luxury tents、制限なしの場合はnone）。このパラメータは施設のカテゴリを絞り込むもので、特定の部屋タイプを絞り込むものではありません。
sort任意- 施設の検索結果を並べ替えます。locationからの距離順はdistance、レビューの総合評価順はpopular、ゲストのレビュースコアではなく星評価の順はtop_ratedを指定します。searchのデフォルトはpopularで、profileのクエリでは並べ替えは無視されます。指定可能な値:
distancepopulartop_rated star_rating任意- 星評価で施設を絞り込みます。1_starから5_stars、星評価のない施設はunrated、制限なしはanyを指定できます。施設の星評価は、ゲストのレビュースコアとは別のものです。指定可能な値:
1_star2_stars3_stars4_stars5_starsanyunratedBooking：星評価、クチコミスコア、品質評価 — Bookingでは、宿泊施設の星評価、ゲストのクチコミスコア、品質評価をそれぞれ別に定義しています。1〜5の星評価は1〜10のクチコミスコアとは異なり、黄色いブロックで表示される品質評価とも混同しないでください。 · 確認日
Bookingのprofileのパラメータはそれぞれどういう意味ですか？
/hotel/ページのリンクから、Booking.comの施設1件の情報を取得します。説明、施設タイプ、公式の星評価、カテゴリ別評価を含むゲストスコア、設備、住所、提示料金が含まれます。公式のstarsとゲストのratingは別の指標です。日付を指定しても料金は確定しません。
url必須- 単一の施設ページの完全なURLを指定します。/hotel/形式のパスを推奨します。profileでは詳細の取得、reviewsでは施設のレビューの取得、pricesでは客室料金の確認に使用します。目的地の検索URLには対応していません。Booking：施設ページの星評価とクチコミスコア — Bookingでは、宿泊施設の星評価、ゲストのクチコミスコア、品質評価を区別しています。profileアクションは、URLで指定した公開施設ページを1件読み取ります。この出典は返される評価の用語を説明するものであり、評価をリクエストのフィルターにしたり、予約を保証したりするものではありません。 · 確認日
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課金には影響しません。指定可能な値:
aedarsaudaznbgnbhdbrlcadchfclpcnycopczkdkkegpeurfjdgbpgelhkdhufidrilsinrjodjpykrwkwdkztmdlmxnmyrnadnoknzdomrplnqarronrubsarseksgdthbtrytwduahusdxofzar lang任意- 宿泊施設ページの表示言語を指定します。デフォルトはイギリス英語です。イギリス英語またはアメリカ英語にはengbまたはenus、簡体字中国語または繁体字中国語にはzhcnまたはzhtwを指定します（汎用のenやzhは渡さないでください）。このパラメータはレビュー本文を翻訳しません。指定可能な値:
arbgcacsdadeelengbenusesesaretfifrhehrhuidisitjakoltlvmsnlnoplptbrptptroruskslsrsvthtltrukvizhcnzhtw
Bookingのreviewsのパラメータはそれぞれどういう意味ですか？
Booking.comの施設に寄せられたゲストレビューを収集します。良かった点と悪かった点のテキストは別々に保持され、スコア、宿泊月、旅行者タイプ、客室、ホテルからの返信も含まれます。どちらか一方が空の場合もあり、1回の取得ですべてのレビューが含まれるとは限りません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況url必須- 単一の施設ページの完全なURLを指定します。/hotel/形式のパスを推奨します。profileでは詳細の取得、reviewsでは施設のレビューの取得、pricesでは客室料金の確認に使用します。目的地の検索URLには対応していません。Booking：ゲストのクチコミとカテゴリ別評価 — Bookingのドキュメントによると、総合クチコミスコアと各カテゴリのスコアはそれぞれ個別に投稿されます。これは公式サイト上の説明を参照したものです。このAPIアクションのクチコミ評価の尺度は入力形式ごとに確認する必要があり、このリンクを引用していても、正規化の検証が済んでいることにはなりません。 · 確認日
Bookingのpricesのパラメータはそれぞれどういう意味ですか？
Booking.comの施設の客室料金を日ごとに比較します。客室タイプ、元の料金と現在の料金、税金、返金の可否、食事プラン、残室数を取得できます。daysの期間はデフォルトで7日、最大30日です。各行のcheck_inとcheck_outはホテルの毎日のチェックイン・チェックアウト時刻で、指定した日付ではありません。
url必須- 単一の施設ページの完全なURLを指定します。/hotel/形式のパスを推奨します。profileでは詳細の取得、reviewsでは施設のレビューの取得、pricesでは客室料金の確認に使用します。目的地の検索URLには対応していません。
adults任意- 料金クエリの大人の宿泊人数を整数で指定します。デフォルトは2です。料金クエリのパラメータとしてのみ使用され、返される客室オプションの数を制限したり、予約を開始したりすることはありません。searchは大人2名固定で動作します。
check_in任意- チェックイン日をYYYY-MM-DD形式で指定します。searchおよびprofileアクションで滞在日程を送信するには、check_inとcheck_outの両方が必要です。pricesでは、start_dateを省略した場合に開始日として扱われます。予約は作成されません。
currency任意- 宿泊施設の価格表示に使う通貨を指定します。デフォルトはUSDです。searchおよびprofileアクションでは記載された小文字のコードを、pricesでは大文字3文字のコードを受け付けます。このパラメータはEveryInfraのAPI課金には影響しません。
days任意- 料金を何暦日先まで照会するかを指定します。デフォルトは7で、範囲は1–30です（範囲外の値は下限または上限に補正されます）。照会する日付の期間を決めるもので、個々の客室料金の滞在日数ではありません。Booking：料金と税金の条件 — Bookingによると、料金は宿泊施設側が設定し、税金や手数料は所在地、客室タイプ、宿泊人数によって異なります。何が含まれるかは各料金の説明で確認してください。このアクションは照会のみを行うもので、予約や料金を保証するものではありません。 · 確認日
rooms任意- 料金クエリの客室数を整数で指定します。デフォルトは1です。返される客室オプションの数ではなく、リクエストする客室数を決めます。searchは1室固定で動作します。
start_date任意- pricesで日別料金を照会する開始日をYYYY-MM-DD形式で指定します。check_inと両方を指定した場合は、こちらが優先されます。レビューの投稿日や施設の開業日を表すものではありません。
Booking APIの使い方
- 01公開カタログからプラットフォームのアクションを選択します。
- 02プラットフォーム、アクション、必須パラメータをPOST /api/v1/socialに送信します。
- 03レスポンスから結果を読み取ります。非同期のアクションの場合は、返されたジョブIDをポーリングします。
- 04アプリケーションで必要なレスポンスフィールドを保存します。
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"booking","action":"search","params":{"keyword":"<keyword>"}}'
Booking APIに関する質問
Booking APIでは何を取得できますか？
platformをbookingに設定します。現在のカタログには検索、詳細、レビュー、価格が掲載されています。これらのアクション名はそれぞれ異なるBookingのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
Bookingのsearchリクエストを開始するには、どの入力を使用しますか？
施設の目的地名を指定します（例：Amsterdam）。searchアクションでホテル、アパートメントなどの宿泊施設を検索する際に使用します。フライト、観光スポット、レビューのキーワードには使用しません。params内のkeywordとして送信してください。
Bookingのsearchはどのフィールドを返しますか？
宣言されたスキーマにはname、type、text、starsが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
Bookingのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。