プラットフォームの稼働状況
- 24時間の稼働状況
- 正常
過去30日間
利用可能な機能
Airbnbの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
検索search | keywordで指定した目的地のAirbnb宿泊先を検索します。通貨、言語、価格帯のフィルタは任意です。各行には表示どおりの物件タイプ、定員、料金、評価が含まれますが、特定の日付に空きがあることを確認するものではありません。 | 1,000リクエストあたり$1.39 | 正常 |
物件詳細property_detail | /rooms/リンクまたは物件IDから、Airbnbのリスティングを1件取得します。部屋タイプ、定員、寝室数、ベッド数、バスルーム数、アメニティ、評価、ホストを取得できます。任意のcityや価格フィルタを指定しても、検索や予約見積もりにはなりません。 | 1,000リクエストあたり$1.39 | 正常 |
レビューreviews | Airbnbリスティングのゲストレビューを取得します。各レビューには本文、評価、日付、言語、レビュー投稿者の名前と所在地、ホストの返信（ある場合）が含まれます。言語、sinceで指定する日付、または並び順で絞り込めます。1回の取得結果だけでレビュー履歴全体を網羅するとは限りません。 | 1,000リクエストあたり$1.39 | 正常 |
ホストのプロフィールhost | プロフィールリンクまたはホストIDからAirbnbのホストを検索します。名前、自己紹介、対応言語、評価、スーパーホストかどうか、登録日、リスティング数を取得できます。リスティングIDではなく、/users/show/リンクまたはホストIDを指定してください。このプロフィールでホストの本人確認ができるわけではありません。 | 1,000リクエストあたり$1.39 | 正常 |
空き状況カレンダーcalendar | Airbnbリスティングの日別の空き状況を確認します。各日付について、チェックイン・チェックアウトの可否、最短・最長宿泊数、料金がわかります。日付を指定しない場合は、今日から30日間が対象です。カレンダーを取得しても、宿泊が仮押さえ・予約されることはありません。 | 1,000リクエストあたり$1.39 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
Airbnbの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
search検索
| keyword | currency, lang, locale, max_price, min_price | Sync配信 | カタログ値：defaultLimit=20、maxLimit=100。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · url · title · text · property_type · person_capacity · price · rating · rating_scale · review_count · lat · lng · location · host_name · amenities · image_url · check_in · check_out · platform |
property_detail物件詳細 /rooms/リンクまたは物件IDから、Airbnbのリスティングを1件取得します。部屋タイプ、定員、寝室数、ベッド数、バスルーム数、アメニティ、評価、ホストを取得できます。任意の | url | city, max_price, min_price | Sync配信 | — | 1,000リクエストあたり$1.39 | id · url · title · text · property_type · room_type · person_capacity · bedrooms · bathrooms · beds · location · lat · lng · rating · rating_scale · review_count · price · currency · host_name · is_superhost · amenities · platform |
reviewsレビュー Airbnbリスティングのゲストレビューを取得します。各レビューには本文、評価、日付、言語、レビュー投稿者の名前と所在地、ホストの返信（ある場合）が含まれます。言語、 | url | lang, locale, since, sort | Sync配信 | カタログ値：defaultLimit=20、maxLimit=100。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · url · text · rating · rating_scale · posted_at · language · author_name · author_location · response · platform |
hostホストのプロフィール プロフィールリンクまたはホストIDからAirbnbのホストを検索します。名前、自己紹介、対応言語、評価、スーパーホストかどうか、登録日、リスティング数を取得できます。リスティングIDではなく、/users/show/リンクまたはホストIDを指定してください。このプロフィールでホストの本人確認ができるわけではありません。 | url | — | Sync配信 | — | 1,000リクエストあたり$1.39 | id · url · name · text · avatar_url · languages · listing_count · rating · rating_scale · review_count · is_superhost · joined_at · listing_urls · platform |
calendar空き状況カレンダー Airbnbリスティングの日別の空き状況を確認します。各日付について、チェックイン・チェックアウトの可否、最短・最長宿泊数、料金がわかります。日付を指定しない場合は、今日から30日間が対象です。カレンダーを取得しても、宿泊が仮押さえ・予約されることはありません。 | url | check_in, check_out, end_date, since, start_date, until | Sync配信 | — | 1,000リクエストあたり$1.39 | id · date · available · available_for_checkin · available_for_checkout · bookable · min_nights · max_nights · price · currency · platform |
Airbnbのsearchのパラメータはそれぞれどういう意味ですか？
keywordで指定した目的地のAirbnb宿泊先を検索します。通貨、言語、価格帯のフィルタは任意です。各行には表示どおりの物件タイプ、定員、料金、評価が含まれますが、特定の日付に空きがあることを確認するものではありません。
keyword必須- searchアクションの対象となる場所、都市、地域、または目的地の名前（例：Tokyo）を指定します。ホストのユーザー名や物件IDではなく、地名を渡してください。
currency任意- Airbnbの検索結果に表示する物件価格の通貨を指定します（デフォルトはUSD。指定可能な値を参照）。この設定で変わるのは物件価格の通貨のみで、EveryInfra APIのリクエスト課金やウォレットの通貨は変わりません。指定可能な値:
aedaudbgnbrlcadchfclpcnycopcrcczkdkkegpeurgbpghshkdhrkhufidrilsinrjpykeskrwkztmadmxnmyrnoknzdpenphpplnqarronsarseksgdthbtrytwduahugxusduyuvndzar lang任意- 言語と地域の組み合わせを、en-USならenus、zh-CNならzhcn、ja-JPならjajpのような短縮コードで指定します。enのような一般的な2文字の言語コードではなく、記載された指定可能な値のいずれかをそのまま渡してください。指定可能な値:
arxxazazbgbgbsbacaescsczdadkdeatdechdededeluelgrenaeenauencaengbengyenieeninennzensgenuses419esaresboesbzesclescoescresecesesesgteshnesmxesniespaespeespyessvesusesveeteefififrbefrcafrchfrfrfrlugaieheilhiinhrhrhuhuhyamididisisitchititjajpkagekokrltltlvlvmkmkmsmymtmtnlbenlnlnonoplplptbrptptrororuruskskslsisqalsrmesrrssvseswxxththtlphtrtrukuavivnxhzazhcnzhhkzhtwzhtwuszhuszuza locale任意- Airbnbページの表示ロケールを指定します（デフォルトはen-US）。例：en-US、zh-CN。localeとlangを同時に渡さないでください。langが優先され、言語の選択を上書きします。このパラメータでレビュー投稿者の国籍によるフィルタリングはできません。
max_price任意- 物件価格の上限フィルターを数値で指定します。min_price以上である必要があります。検索結果の絞り込みに使用するもので、1回のAPIリクエストの費用や宿泊予算全体を制限するものではありません。フィルターは整数で適用され、小数は切り上げられます（145.98は146になります）。
min_price任意- max_priceと組み合わせて、物件価格の下限フィルターを数値で指定します。このパラメータは物件の検索結果を絞り込むもので、APIの利用上限を設定するものではありません。フィルターは整数で適用され、小数は切り捨てられます（39.81は39になります）。
Airbnbのproperty_detailのパラメータはそれぞれどういう意味ですか？
/rooms/リンクまたは物件IDから、Airbnbのリスティングを1件取得します。部屋タイプ、定員、寝室数、ベッド数、バスルーム数、アメニティ、評価、ホストを取得できます。任意のcityや価格フィルタを指定しても、検索や予約見積もりにはなりません。
url必須- アクションに応じて対象リソースを指定します。property_detail、reviews、calendarでは/rooms/<property_id>のURLまたは物件ID、hostでは/users/show/<host_id>のURLまたはホストIDを渡してください。物件IDとホストIDは互換性がありません。Airbnb：リスティングのレビューと公開範囲 — Airbnbでは、公開されるレビューと総合的な星評価を、ホストとプラットフォームのみが閲覧できるカテゴリ別の評価と区別しています。リスティングの総合スコアと、複数のリスティングにまたがるホストのスコアは別々に算出されるため、混同しないでください。 · 確認日
city任意- 物件詳細のクエリで使用する、都市名の自由テキストフィルターを指定します。物件IDや国コードではなく、都市名を入力してください。
max_price任意- 物件価格の上限フィルターを数値で指定します。min_price以上である必要があります。検索結果の絞り込みに使用するもので、1回のAPIリクエストの費用や宿泊予算全体を制限するものではありません。フィルターは整数で適用され、小数は切り上げられます（145.98は146になります）。
min_price任意- max_priceと組み合わせて、物件価格の下限フィルターを数値で指定します。このパラメータは物件の検索結果を絞り込むもので、APIの利用上限を設定するものではありません。フィルターは整数で適用され、小数は切り捨てられます（39.81は39になります）。
Airbnbのreviewsのパラメータはそれぞれどういう意味ですか？
Airbnbリスティングのゲストレビューを取得します。各レビューには本文、評価、日付、言語、レビュー投稿者の名前と所在地、ホストの返信（ある場合）が含まれます。言語、sinceで指定する日付、または並び順で絞り込めます。1回の取得結果だけでレビュー履歴全体を網羅するとは限りません。
url必須- アクションに応じて対象リソースを指定します。property_detail、reviews、calendarでは/rooms/<property_id>のURLまたは物件ID、hostでは/users/show/<host_id>のURLまたはホストIDを渡してください。物件IDとホストIDは互換性がありません。Airbnb：リスティングのレビューと公開範囲 — Airbnbでは、公開されるレビューと総合的な星評価を、ホストとプラットフォームのみが閲覧できるカテゴリ別の評価と区別しています。リスティングの総合スコアと、複数のリスティングにまたがるホストのスコアは別々に算出されるため、混同しないでください。 · 確認日
lang任意- 言語と地域の組み合わせを、en-USならenus、zh-CNならzhcn、ja-JPならjajpのような短縮コードで指定します。enのような一般的な2文字の言語コードではなく、記載された指定可能な値のいずれかをそのまま渡してください。指定可能な値:
arxxazazbgbgbsbacaescsczdadkdeatdechdededeluelgrenaeenauencaengbengyenieeninennzensgenuses419esaresboesbzesclescoescresecesesesgteshnesmxesniespaespeespyessvesusesveeteefififrbefrcafrchfrfrfrlugaieheilhiinhrhrhuhuhyamididisisitchititjajpkagekokrltltlvlvmkmkmsmymtmtnlbenlnlnonoplplptbrptptrororuruskskslsisqalsrmesrrssvseswxxththtlphtrtrukuavivnxhzazhcnzhhkzhtwzhtwuszhuszuza locale任意- Airbnbページの表示ロケールを指定します（デフォルトはen-US）。例：en-US、zh-CN。localeとlangを同時に渡さないでください。langが優先され、言語の選択を上書きします。このパラメータでレビュー投稿者の国籍によるフィルタリングはできません。
since任意- YYYY-MM-DD形式の開始日を指定します。適用範囲はアクションによって異なります。reviewsではレビューの開始日、calendarでは日付範囲の開始日となり、start_dateとcheck_inを上書きします。
sort任意- ゲストレビューの並び順をnewest（デフォルト）、relevance、top_ratedから指定します。このパラメータはレビューの並び順にのみ適用され、物件価格には影響しません。指定可能な値:
newestrelevancetop_rated
Airbnbのhostのパラメータはそれぞれどういう意味ですか？
プロフィールリンクまたはホストIDからAirbnbのホストを検索します。名前、自己紹介、対応言語、評価、スーパーホストかどうか、登録日、リスティング数を取得できます。リスティングIDではなく、/users/show/リンクまたはホストIDを指定してください。このプロフィールでホストの本人確認ができるわけではありません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況url必須- アクションに応じて対象リソースを指定します。property_detail、reviews、calendarでは/rooms/<property_id>のURLまたは物件ID、hostでは/users/show/<host_id>のURLまたはホストIDを渡してください。物件IDとホストIDは互換性がありません。Airbnb：ホストの評価とリスティングの評価 — Airbnbは、リスティングの総合評価を集計してホストの評価を算出しています。ホストのプロフィールのスコアを取得しても、その評価を個々の物件にそのまま当てはめることはできません。 · 確認日
Airbnbのcalendarのパラメータはそれぞれどういう意味ですか？
Airbnbリスティングの日別の空き状況を確認します。各日付について、チェックイン・チェックアウトの可否、最短・最長宿泊数、料金がわかります。日付を指定しない場合は、今日から30日間が対象です。カレンダーを取得しても、宿泊が仮押さえ・予約されることはありません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況url必須- アクションに応じて対象リソースを指定します。property_detail、reviews、calendarでは/rooms/<property_id>のURLまたは物件ID、hostでは/users/show/<host_id>のURLまたはホストIDを渡してください。物件IDとホストIDは互換性がありません。
check_in任意- calendarアクションの互換用の開始日をYYYY-MM-DD形式で指定します。start_dateも指定した場合はstart_dateが優先され、sinceを指定するといずれも上書きされます。カレンダーの日付を照会しても予約は行われません。
check_out任意- calendarアクションの互換用の終了日をYYYY-MM-DD形式で指定します。end_dateも指定した場合はend_dateが優先され、untilを指定するといずれも上書きされます。カレンダーの日付を照会しても物件の空室は確保されません。
end_date任意- カレンダーの空室状況の照会に使う終了日をYYYY-MM-DD形式で指定します。省略した場合はcheck_out、それもなければ照会日から30日後が使われます（start_dateから30日後ではありません）。untilを指定するとこのパラメータは上書きされます。
since任意- YYYY-MM-DD形式の開始日を指定します。適用範囲はアクションによって異なります。reviewsではレビューの開始日、calendarでは日付範囲の開始日となり、start_dateとcheck_inを上書きします。
start_date任意- カレンダーの空室状況の照会に使う開始日をYYYY-MM-DD形式で指定します。省略した場合はcheck_in、それもなければ当日の日付が使われます。sinceを指定するとこのパラメータは上書きされます。
until任意- calendarアクションの終了日をYYYY-MM-DD形式で指定し、end_dateとcheck_outを上書きします。このパラメータはカレンダーの日付範囲を制御するもので、レビューの投稿日によるフィルタリングは行いません。
Airbnb 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":"airbnb","action":"search","params":{"keyword":"<keyword>"}}'
Airbnb APIに関する質問
Airbnb APIでは何を取得できますか？
platformをairbnbに設定します。現在のカタログには検索、物件詳細、レビュー、ホストのプロフィール、空き状況カレンダーが掲載されています。これらのアクション名はそれぞれ異なるAirbnbのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
Airbnbのsearchリクエストを開始するには、どの入力を使用しますか？
searchアクションの対象となる場所、都市、地域、または目的地の名前（例：Tokyo）を指定します。ホストのユーザー名や物件IDではなく、地名を渡してください。params内のkeywordとして送信してください。
Airbnbのsearchはどのフィールドを返しますか？
宣言されたスキーマにはtitle、text、property_type、person_capacityが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
Airbnbのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。