プラットフォームの稼働状況
- 24時間の稼働状況
- 正常
過去30日間
利用可能な機能
TripAdvisorの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
検索search | キーワードでTripAdvisorのホテル、レストラン、観光スポットを検索します。カテゴリ、評価、レビュー数、都市内順位、価格帯、住所を取得できます。同名の場所を区別するには、都市名を追加してください。price_levelは金額ではなく、ドル記号で表した価格帯です。 | 1,000リクエストあたり$1.39 | 正常 |
詳細profile | TripAdvisorでホテル、レストラン、観光スポットのいずれか1件の掲載情報を取得します。評価、レビュー数、都市内順位、価格帯、住所、座標、連絡先を取得できます。都市の一覧ページではなく、その場所自体のページを渡してください。特定日の料金や空き状況は対象外です。 | 1,000リクエストあたり$1.39 | 正常 |
レビューreviews | TripAdvisorのホテル、レストラン、観光スポットに投稿された旅行者のレビューを取得します。評価、旅行タイプと日付、レビュアー情報、オーナーからの返信が含まれます。情報の新しさはposted_atではなくtrip_dateで判断してください。また、その場所のすべてのレビューが取得できるわけではありません。 | 1,000リクエストあたり$1.39 | 正常 |
Restaurantsrestaurants | キーワードでTripAdvisorのレストランを検索します。料理ジャンル、評価、レビュー数、都市内順位、価格帯、連絡先が含まれます。席の空き状況、メニュー、現在の営業時間は確認されていません。 | 1,000リクエストあたり$1.39 | 正常 |
Attractionsattractions | 都市名または観光スポット名を指定して、TripAdvisorの観光スポットを閲覧できます。カテゴリ、評価、レビュー数、その地域の観光スポット内での順位、住所が含まれます。チケットの販売は行っておらず、営業時間やアクセシビリティは保証されません。 | 1,000リクエストあたり$1.39 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
TripAdvisorの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
search検索 キーワードでTripAdvisorのホテル、レストラン、観光スポットを検索します。カテゴリ、評価、レビュー数、都市内順位、価格帯、住所を取得できます。同名の場所を区別するには、都市名を追加してください。 | keyword | content_type, currency, lang | Sync配信 | カタログ値：defaultLimit=10、maxLimit=30。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · name · category · url · text · rating · rating_scale · review_count · price_level · ranking · address · city · country · location · phone · email · website · latitude · longitude · image_url · platform · cuisines |
profile詳細 TripAdvisorでホテル、レストラン、観光スポットのいずれか1件の掲載情報を取得します。評価、レビュー数、都市内順位、価格帯、住所、座標、連絡先を取得できます。都市の一覧ページではなく、その場所自体のページを渡してください。特定日の料金や空き状況は対象外です。 | url | content_type, currency, lang | Sync配信 | — | 1,000リクエストあたり$1.39 | id · name · category · url · text · rating · rating_scale · review_count · price_level · ranking · address · city · country · location · phone · email · website · latitude · longitude · image_url · platform · cuisines |
reviewsレビュー TripAdvisorのホテル、レストラン、観光スポットに投稿された旅行者のレビューを取得します。評価、旅行タイプと日付、レビュアー情報、オーナーからの返信が含まれます。情報の新しさは | url | — | Sync配信 | カタログ値：defaultLimit=20、maxLimit=50。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · url · title · text · rating · rating_scale · like_count · author_name · author_username · author_location · author_contributions · trip_type · trip_date · posted_at · language · platform · owner_response · image_urls |
restaurantsRestaurants キーワードでTripAdvisorのレストランを検索します。料理ジャンル、評価、レビュー数、都市内順位、価格帯、連絡先が含まれます。席の空き状況、メニュー、現在の営業時間は確認されていません。 | keyword | content_type, currency, lang | Sync配信 | カタログ値：defaultLimit=10、maxLimit=30。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · name · category · url · text · rating · rating_scale · review_count · price_level · ranking · address · city · country · location · phone · email · website · latitude · longitude · image_url · platform · cuisines |
attractionsAttractions 都市名または観光スポット名を指定して、TripAdvisorの観光スポットを閲覧できます。カテゴリ、評価、レビュー数、その地域の観光スポット内での順位、住所が含まれます。チケットの販売は行っておらず、営業時間やアクセシビリティは保証されません。 | keyword | content_type, currency, lang | Sync配信 | カタログ値：defaultLimit=10、maxLimit=30。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · name · category · url · text · rating · rating_scale · review_count · price_level · ranking · address · city · country · location · phone · email · website · latitude · longitude · image_url · platform · cuisines |
TripAdvisorのsearchのパラメータはそれぞれどういう意味ですか？
キーワードでTripAdvisorのホテル、レストラン、観光スポットを検索します。カテゴリ、評価、レビュー数、都市内順位、価格帯、住所を取得できます。同名の場所を区別するには、都市名を追加してください。price_levelは金額ではなく、ドル記号で表した価格帯です。
keyword必須- ロケーションを検索するためのクエリ文字列です。
searchアクションはホテル、レストラン、観光スポットを横断して検索し、restaurantsとattractionsはそれぞれの対象に限定して検索します。都市名を付け加えると、同名の施設を区別しやすくなります。このパラメータではレビューの全文検索を行いません。 content_type任意- ロケーションの写真を投稿元で絞り込みます。指定できる値は
from_everyone（すべての写真）、from_management（オーナーによるアップロード）、from_travelers（訪問者によるアップロード）です。ホテル、レストラン、観光スポットなどのロケーションのカテゴリーでは絞り込みません。特定の種類のロケーションを対象にするには、対応するアクションを選択してください。指定可能な値:from_everyonefrom_managementfrom_travelers currency任意- ロケーションの価格表示に使用する通貨コードで、デフォルトは
usdです（主な選択肢はeur、gbp、cnyなど）。スキーマの列挙値はすべて維持されていますが、対応している過去の通貨コードでは、現在の価格がリアルタイムで返されない場合があります。このパラメータはAPIの課金通貨には影響しません。指定可能な値:aedafnallamdarsaudaznbambdtbgnbhdbifbndbobbrlbwpbynbzdcadcdfchfclpcnycopcrccveczkdjfdkkdopdzdeekegpernetbeurgbpgelghsgnfgtqhkdhnlhrkhufidrilsinriqdirriskjmdjodjpykeskhrkmfkrwkwdkztlbplkrltllvllydmadmdlmgamkdmmkmopmurmxnmyrmznnadngnnionoknprnzdomrpabpenphppkrplnpygqarronrsdrubrwfsarsdgseksgdsossypthbtndtoptryttdtwdtzsuahugxusduyuuzsvefvndxafxofyerzarzmkzwl lang任意- search、profile、restaurants、attractionsで使用する2文字の言語コード（
en、zhなど）です。reviewsアクションではこのパラメータを使用しません。指定可能な値:aaabaeafakamanarasavayazbabebgbhbibmbnbobrbscacechcocrcscucvcydadedveeeleneoeseteufafffifjfofrfygagdglgngugvhahehihohrhthuhyhziaidieigiiikioisitiuiwjajvkakgkikjkkklkmknkokrkskukvkwkylalblglilnloltlulvmgmhmimkmlmnmrmsmtmynanbndnengnlnnnonrnvnyocojomorospapiplpsptqurmrnrorurwsascsdsesgsiskslsmsnsosqsrssstsusvswtatetgthtitktltntotrtstttwtyugukuruzvevivowawoxhyiyozazh
TripAdvisorのprofileのパラメータはそれぞれどういう意味ですか？
TripAdvisorでホテル、レストラン、観光スポットのいずれか1件の掲載情報を取得します。評価、レビュー数、都市内順位、価格帯、住所、座標、連絡先を取得できます。都市の一覧ページではなく、その場所自体のページを渡してください。特定日の料金や空き状況は対象外です。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況url必須profileおよびreviewsアクションで対象とするTripAdvisorの施設URLです。都市ディレクトリではなく、ホテル、レストラン、観光スポットの掲載ページを直接指定してください。profileでは、ユーザープロフィールではなく施設の詳細を取得します。Tripadvisor：人気ランキングと評価 — Tripadvisorの人気ランキングは、クチコミの質、新しさ、件数、長期にわたる実績に基づいています。ランキングは同じ地域の他の施設の実績にも左右され、単に平均評価を別の形で表したものではありません。 · 確認日content_type任意- ロケーションの写真を投稿元で絞り込みます。指定できる値は
from_everyone（すべての写真）、from_management（オーナーによるアップロード）、from_travelers（訪問者によるアップロード）です。ホテル、レストラン、観光スポットなどのロケーションのカテゴリーでは絞り込みません。特定の種類のロケーションを対象にするには、対応するアクションを選択してください。指定可能な値:from_everyonefrom_managementfrom_travelers currency任意- ロケーションの価格表示に使用する通貨コードで、デフォルトは
usdです（主な選択肢はeur、gbp、cnyなど）。スキーマの列挙値はすべて維持されていますが、対応している過去の通貨コードでは、現在の価格がリアルタイムで返されない場合があります。このパラメータはAPIの課金通貨には影響しません。指定可能な値:aedafnallamdarsaudaznbambdtbgnbhdbifbndbobbrlbwpbynbzdcadcdfchfclpcnycopcrccveczkdjfdkkdopdzdeekegpernetbeurgbpgelghsgnfgtqhkdhnlhrkhufidrilsinriqdirriskjmdjodjpykeskhrkmfkrwkwdkztlbplkrltllvllydmadmdlmgamkdmmkmopmurmxnmyrmznnadngnnionoknprnzdomrpabpenphppkrplnpygqarronrsdrubrwfsarsdgseksgdsossypthbtndtoptryttdtwdtzsuahugxusduyuuzsvefvndxafxofyerzarzmkzwl lang任意- search、profile、restaurants、attractionsで使用する2文字の言語コード（
en、zhなど）です。reviewsアクションではこのパラメータを使用しません。指定可能な値:aaabaeafakamanarasavayazbabebgbhbibmbnbobrbscacechcocrcscucvcydadedveeeleneoeseteufafffifjfofrfygagdglgngugvhahehihohrhthuhyhziaidieigiiikioisitiuiwjajvkakgkikjkkklkmknkokrkskukvkwkylalblglilnloltlulvmgmhmimkmlmnmrmsmtmynanbndnengnlnnnonrnvnyocojomorospapiplpsptqurmrnrorurwsascsdsesgsiskslsmsnsosqsrssstsusvswtatetgthtitktltntotrtstttwtyugukuruzvevivowawoxhyiyozazh
TripAdvisorのreviewsのパラメータはそれぞれどういう意味ですか？
TripAdvisorのホテル、レストラン、観光スポットに投稿された旅行者のレビューを取得します。評価、旅行タイプと日付、レビュアー情報、オーナーからの返信が含まれます。情報の新しさはposted_atではなくtrip_dateで判断してください。また、その場所のすべてのレビューが取得できるわけではありません。
url必須profileおよびreviewsアクションで対象とするTripAdvisorの施設URLです。都市ディレクトリではなく、ホテル、レストラン、観光スポットの掲載ページを直接指定してください。profileでは、ユーザープロフィールではなく施設の詳細を取得します。
TripAdvisorのrestaurantsのパラメータはそれぞれどういう意味ですか？
キーワードでTripAdvisorのレストランを検索します。料理ジャンル、評価、レビュー数、都市内順位、価格帯、連絡先が含まれます。席の空き状況、メニュー、現在の営業時間は確認されていません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況keyword必須- ロケーションを検索するためのクエリ文字列です。
searchアクションはホテル、レストラン、観光スポットを横断して検索し、restaurantsとattractionsはそれぞれの対象に限定して検索します。都市名を付け加えると、同名の施設を区別しやすくなります。このパラメータではレビューの全文検索を行いません。 content_type任意- ロケーションの写真を投稿元で絞り込みます。指定できる値は
from_everyone（すべての写真）、from_management（オーナーによるアップロード）、from_travelers（訪問者によるアップロード）です。ホテル、レストラン、観光スポットなどのロケーションのカテゴリーでは絞り込みません。特定の種類のロケーションを対象にするには、対応するアクションを選択してください。指定可能な値:from_everyonefrom_managementfrom_travelers currency任意- ロケーションの価格表示に使用する通貨コードで、デフォルトは
usdです（主な選択肢はeur、gbp、cnyなど）。スキーマの列挙値はすべて維持されていますが、対応している過去の通貨コードでは、現在の価格がリアルタイムで返されない場合があります。このパラメータはAPIの課金通貨には影響しません。指定可能な値:aedafnallamdarsaudaznbambdtbgnbhdbifbndbobbrlbwpbynbzdcadcdfchfclpcnycopcrccveczkdjfdkkdopdzdeekegpernetbeurgbpgelghsgnfgtqhkdhnlhrkhufidrilsinriqdirriskjmdjodjpykeskhrkmfkrwkwdkztlbplkrltllvllydmadmdlmgamkdmmkmopmurmxnmyrmznnadngnnionoknprnzdomrpabpenphppkrplnpygqarronrsdrubrwfsarsdgseksgdsossypthbtndtoptryttdtwdtzsuahugxusduyuuzsvefvndxafxofyerzarzmkzwl lang任意- search、profile、restaurants、attractionsで使用する2文字の言語コード（
en、zhなど）です。reviewsアクションではこのパラメータを使用しません。指定可能な値:aaabaeafakamanarasavayazbabebgbhbibmbnbobrbscacechcocrcscucvcydadedveeeleneoeseteufafffifjfofrfygagdglgngugvhahehihohrhthuhyhziaidieigiiikioisitiuiwjajvkakgkikjkkklkmknkokrkskukvkwkylalblglilnloltlulvmgmhmimkmlmnmrmsmtmynanbndnengnlnnnonrnvnyocojomorospapiplpsptqurmrnrorurwsascsdsesgsiskslsmsnsosqsrssstsusvswtatetgthtitktltntotrtstttwtyugukuruzvevivowawoxhyiyozazh
TripAdvisorのattractionsのパラメータはそれぞれどういう意味ですか？
都市名または観光スポット名を指定して、TripAdvisorの観光スポットを閲覧できます。カテゴリ、評価、レビュー数、その地域の観光スポット内での順位、住所が含まれます。チケットの販売は行っておらず、営業時間やアクセシビリティは保証されません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況keyword必須- ロケーションを検索するためのクエリ文字列です。
searchアクションはホテル、レストラン、観光スポットを横断して検索し、restaurantsとattractionsはそれぞれの対象に限定して検索します。都市名を付け加えると、同名の施設を区別しやすくなります。このパラメータではレビューの全文検索を行いません。 content_type任意- ロケーションの写真を投稿元で絞り込みます。指定できる値は
from_everyone（すべての写真）、from_management（オーナーによるアップロード）、from_travelers（訪問者によるアップロード）です。ホテル、レストラン、観光スポットなどのロケーションのカテゴリーでは絞り込みません。特定の種類のロケーションを対象にするには、対応するアクションを選択してください。指定可能な値:from_everyonefrom_managementfrom_travelers currency任意- ロケーションの価格表示に使用する通貨コードで、デフォルトは
usdです（主な選択肢はeur、gbp、cnyなど）。スキーマの列挙値はすべて維持されていますが、対応している過去の通貨コードでは、現在の価格がリアルタイムで返されない場合があります。このパラメータはAPIの課金通貨には影響しません。指定可能な値:aedafnallamdarsaudaznbambdtbgnbhdbifbndbobbrlbwpbynbzdcadcdfchfclpcnycopcrccveczkdjfdkkdopdzdeekegpernetbeurgbpgelghsgnfgtqhkdhnlhrkhufidrilsinriqdirriskjmdjodjpykeskhrkmfkrwkwdkztlbplkrltllvllydmadmdlmgamkdmmkmopmurmxnmyrmznnadngnnionoknprnzdomrpabpenphppkrplnpygqarronrsdrubrwfsarsdgseksgdsossypthbtndtoptryttdtwdtzsuahugxusduyuuzsvefvndxafxofyerzarzmkzwl lang任意- search、profile、restaurants、attractionsで使用する2文字の言語コード（
en、zhなど）です。reviewsアクションではこのパラメータを使用しません。指定可能な値:aaabaeafakamanarasavayazbabebgbhbibmbnbobrbscacechcocrcscucvcydadedveeeleneoeseteufafffifjfofrfygagdglgngugvhahehihohrhthuhyhziaidieigiiikioisitiuiwjajvkakgkikjkkklkmknkokrkskukvkwkylalblglilnloltlulvmgmhmimkmlmnmrmsmtmynanbndnengnlnnnonrnvnyocojomorospapiplpsptqurmrnrorurwsascsdsesgsiskslsmsnsosqsrssstsusvswtatetgthtitktltntotrtstttwtyugukuruzvevivowawoxhyiyozazh
TripAdvisor APIの使い方
- 01公開カタログからプラットフォームのアクションを選択します。
- 02プラットフォーム、アクション、必須パラメータをPOST /api/v1/socialに送信します。
- 03レスポンスから結果を読み取ります。非同期のアクションの場合は、返されたジョブIDをポーリングします。
- 04アプリケーションで必要なレスポンスフィールドを保存します。
tripadvisor_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"tripadvisor","action":"search","params":{"keyword":"<keyword>"}}'
TripAdvisor APIに関する質問
TripAdvisor APIでは何を取得できますか？
platformをtripadvisorに設定します。現在のカタログには検索、詳細、レビュー、restaurants、attractionsが掲載されています。これらのアクション名はそれぞれ異なるTripAdvisorのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
TripAdvisorのsearchリクエストを開始するには、どの入力を使用しますか？
ロケーションを検索するためのクエリ文字列です。searchアクションはホテル、レストラン、観光スポットを横断して検索し、restaurantsとattractionsはそれぞれの対象に限定して検索します。都市名を付け加えると、同名の施設を区別しやすくなります。このパラメータではレビューの全文検索を行いません。params内のkeywordとして送信してください。
TripAdvisorのsearchはどのフィールドを返しますか？
宣言されたスキーマにはname、category、text、ratingが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
TripAdvisorのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。