プラットフォームの稼働状況
- 24時間の稼働状況
- 正常
過去30日間
利用可能な機能
Yelpの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
検索search | 都市名またはZIPコードでYelpのローカルビジネスを検索します。評価、レビュー数、価格帯、カテゴリ、連絡先、営業時間、オーナー確認状況を取得できます。検索のデフォルトはニューヨークのため、必ずlocationを指定してください。health_scoreはレストランにのみ表示されます。 | 1,000リクエストあたり$1.39 | 正常 |
詳細profile | /biz/リンクからYelpのビジネスページを開きます。評価、価格帯、カテゴリ、連絡先、住所、営業時間、設備・サービス、ハイライト、写真を取得できます。オーナー未確認のページ（is_claimedで判別）は情報が古い場合があります。ここに含まれる情報は所有権や許認可を証明するものではありません。 | 1,000リクエストあたり$1.39 | 正常 |
レビューreviews | 1つのビジネスのYelpレビューを1ページ10件ずつ取得します。各レビューには本文、評価、日付、投稿者、写真数、「役に立った」「面白い」「クール」の投票数が含まれます。次のページを取得するには、next_page_tokenをpage_tokenとして渡します。トークンの有効期間は24時間です。 | 1,000リクエストあたり$1.39 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
Yelpの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
search検索 都市名またはZIPコードでYelpのローカルビジネスを検索します。評価、レビュー数、価格帯、カテゴリ、連絡先、営業時間、オーナー確認状況を取得できます。検索のデフォルトはニューヨークのため、必ず | keyword | location | Sync配信 | カタログ値：defaultLimit=10、maxLimit=50。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · name · url · rating · rating_scale · review_count · price_range · categories · image_url · platform · phone · website · cuisine · description · address · city · region · postal_code · country · is_claimed · is_verified · health_score · established_year · images · amenities · highlights · hours |
profile詳細 /biz/リンクからYelpのビジネスページを開きます。評価、価格帯、カテゴリ、連絡先、住所、営業時間、設備・サービス、ハイライト、写真を取得できます。オーナー未確認のページ（ | url | — | Sync配信 | — | 1,000リクエストあたり$1.39 | id · name · url · rating · rating_scale · review_count · price_range · phone · website · categories · cuisine · description · address · city · region · postal_code · country · is_claimed · is_verified · health_score · established_year · image_url · platform · images · amenities · highlights · hours |
reviewsレビュー 1つのビジネスのYelpレビューを1ページ10件ずつ取得します。各レビューには本文、評価、日付、投稿者、写真数、「役に立った」「面白い」「クール」の投票数が含まれます。次のページを取得するには、 | url | page_token | Sync配信 | カタログ値：defaultLimit=10、maxLimit=10。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。より大きいlimitも指定できますが、10が上限として適用されます。 次のページを取得するには、他のパラメータは変えずにnext_page_tokenをpage_tokenとして渡します。1ページにつき1回の呼び出しです。 1ページあたり最大100行です。50行を超える場合は、mode=asyncでページをリクエストしてください。 | 1,000リクエストあたり$1.39 | id · text · rating · rating_scale · posted_at · author_name · useful_count · photo_count · business_name · business_url · platform · funny_count · cool_count |
Yelpのsearchのパラメータはそれぞれどういう意味ですか？
都市名またはZIPコードでYelpのローカルビジネスを検索します。評価、レビュー数、価格帯、カテゴリ、連絡先、営業時間、オーナー確認状況を取得できます。検索のデフォルトはニューヨークのため、必ずlocationを指定してください。health_scoreはレストランにのみ表示されます。
keyword必須- Yelpのsearchアクションで、地域のビジネスやサービスの検索語（例：coffee）を指定します。検索地域がデフォルトでニューヨークに設定されないよう、locationを明示的に指定して併用してください。
location任意- ビジネス検索の対象となる都市、地区、または郵便番号を指定します（例：Austin, TX、78701）。レビュー投稿者の所在地ではなく、ビジネスの所在地を表します。
Yelpのprofileのパラメータはそれぞれどういう意味ですか？
/biz/リンクからYelpのビジネスページを開きます。評価、価格帯、カテゴリ、連絡先、住所、営業時間、設備・サービス、ハイライト、写真を取得できます。オーナー未確認のページ（is_claimedで判別）は情報が古い場合があります。ここに含まれる情報は所有権や許認可を証明するものではありません。
url必須- profileおよびreviewsアクションで、ビジネスのメタデータやユーザーレビューを取得するために、/biz/スラッグを含むYelpのビジネスURLを指定します。ユーザープロフィールのリンクには対応していません。
Yelpのreviewsのパラメータはそれぞれどういう意味ですか？
1つのビジネスのYelpレビューを1ページ10件ずつ取得します。各レビューには本文、評価、日付、投稿者、写真数、「役に立った」「面白い」「クール」の投票数が含まれます。次のページを取得するには、next_page_tokenをpage_tokenとして渡します。トークンの有効期間は24時間です。
url必須- profileおよびreviewsアクションで、ビジネスのメタデータやユーザーレビューを取得するために、/biz/スラッグを含むYelpのビジネスURLを指定します。ユーザープロフィールのリンクには対応していません。Yelp：おすすめされていないレビューと総合評価の関係 — Yelpによると、現在おすすめされていないレビューは、ビジネスの総合星評価やレビュー件数に算入されません。そのため、スクレイピングで取得したサンプルの件数や平均スコアを、サイト公式の集計値としてそのまま示すことはできません。 · 確認日
page_token任意- ページネーショントークンです。次のページを取得するには、前回のレスポンスのnext_page_tokenをそのまま渡してください。最初のページでは省略します。それ以外のパラメータはすべて変更しないでください。トークンの有効期間は24時間で、1ページにつき1回の呼び出しとなります。
Yelp 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":"yelp","action":"search","params":{"keyword":"<keyword>"}}'
Yelp APIに関する質問
Yelp APIでは何を取得できますか？
platformをyelpに設定します。現在のカタログには検索、詳細、レビューが掲載されています。これらのアクション名はそれぞれ異なるYelpのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
Yelpのsearchリクエストを開始するには、どの入力を使用しますか？
Yelpのsearchアクションで、地域のビジネスやサービスの検索語（例：coffee）を指定します。検索地域がデフォルトでニューヨークに設定されないよう、locationを明示的に指定して併用してください。params内のkeywordとして送信してください。
Yelpのsearchはどのフィールドを返しますか？
宣言されたスキーマにはname、rating、rating_scale、review_countが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
Yelpのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。