プラットフォームの稼働状況
- 24時間の稼働状況
- 99%
過去30日間
利用可能な機能
Yandexの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
検索search | Yandex Mapsで、都市内のキーワードに一致するビジネスや場所を検索します。住所、電話番号、Webサイト、カテゴリ、評価、レビュー数、座標、現在営業中かどうかを取得できます。locationのデフォルトはモスクワで、categoryで場所の種類を絞り込めます。評価は利用可否や品質を保証するものではありません。 | 1,000リクエストあたり$1.39 | 正常 |
マーケットmarket | Yandex Marketで検索語に一致する商品を比較します。価格、評価、レビュー数と購入数、ショップ名とその評価、在庫状況を取得できます。都市はcityまたは数値のregionコードで指定し、デフォルトはモスクワです。注文は行われず、在庫は保証されません。 | 1,000リクエストあたり$1.39 | 良好・稼働状況99% |
レビューreviews | Yandex Mapsでビジネスのレビューを1回の呼び出しで最大200件収集します。各レビューには本文、スコア、日付、高評価・低評価の数、オーナーの返信が含まれます。Marketの商品リンクではなく、Mapsの場所リンクまたはビジネスIDを渡してください。sortでlowest_ratedを指定すると、評価の低いレビューを先頭に表示できます。 | 1,000リクエストあたり$1.39 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
Yandexの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
search検索 Yandex Mapsで、都市内のキーワードに一致するビジネスや場所を検索します。住所、電話番号、Webサイト、カテゴリ、評価、レビュー数、座標、現在営業中かどうかを取得できます。 | keyword | category, lang, language, location, max_price, min_price, sort | Sync配信 | カタログ値：defaultLimit=20、maxLimit=100。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · url · name · text · address · city · country · categories · rating · rating_scale · review_count · phone · website · lat · lng · is_open_now · platform |
marketマーケット Yandex Marketで検索語に一致する商品を比較します。価格、評価、レビュー数と購入数、ショップ名とその評価、在庫状況を取得できます。都市は | keyword | city, max_price, min_price, region, sort | Sync配信 | カタログ値：defaultLimit=20、maxLimit=100。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · url · title · price · currency · rating · rating_scale · rating_count · review_count · purchase_count · category · shop_name · shop_rating · stock · is_available · image_url · platform |
reviewsレビュー Yandex Mapsでビジネスのレビューを1回の呼び出しで最大200件収集します。各レビューには本文、スコア、日付、高評価・低評価の数、オーナーの返信が含まれます。Marketの商品リンクではなく、Mapsの場所リンクまたはビジネスIDを渡してください。 | url | language, sort | Sync配信 | カタログ値：defaultLimit=20、maxLimit=200。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · url · text · rating · rating_scale · posted_at · language · like_count · dislike_count · comment_count · author_name · owner_reply · business_id · business_name · business_rating · business_review_count · platform |
Yandexのsearchのパラメータはそれぞれどういう意味ですか？
Yandex Mapsで、都市内のキーワードに一致するビジネスや場所を検索します。住所、電話番号、Webサイト、カテゴリ、評価、レビュー数、座標、現在営業中かどうかを取得できます。locationのデフォルトはモスクワで、categoryで場所の種類を絞り込めます。評価は利用可否や品質を保証するものではありません。
keyword必須- Yandexアクションの検索語を指定します。searchではローカルスポット、marketではEC商品が対象です。地図の掲載情報と商品カタログは、それぞれ別のデータセットを検索します。
category任意- Yandexのsearchアクションで、場所のカテゴリを絞り込みます（例：restaurants、cafes、coffee_shops、hotels。noneを指定すると解除されます）。このパラメータはYandex Marketの商品カテゴリには適用されず、指定したkeywordおよびcityと整合している必要があります。指定可能な値:
atmsauto_repairbanksbars_pubsbeauty_salonsburgerscafescar_washcinemascoffee_shopsdentistsdry_cleaningfast_foodfitness_clubsgas_stationsgovernment_servicesgrocery_storeshookah_barshospitalshotelskindergartensmuseumsnonepharmaciespizzarestaurantsschoolsshopping_mallssports_facilitiessushi_rollsveterinary_clinicsYandex Maps：ビジネスプロフィールカード、カテゴリ、評価 — 公式のプロフィールカードのドキュメントでは、ビジネスのカテゴリ、住所、評価、レビュー数、営業情報について説明しています。これは地図上のオブジェクトを説明するものであり、プロフィールカードにボタンがあるからといって、このAPIが予約や地図編集の機能を提供することを意味するものではありません。 · 確認日 lang任意- Yandexのsearchアクションのレスポンス言語を指定します。指定できる値はru、en、kk、tr、ukです。検索インターフェースのロケールを制御するもので、ユーザー投稿のレビュー内容が翻訳されることは保証されません。指定可能な値:
enkkrutruk language任意- Yandexアクションのフォールバック用インターフェース言語を指定します。デフォルトはsearchではru、reviewsではenです。searchアクションでlangを明示的に渡すと、このパラメータより優先されます。
location任意- Yandexのsearchアクションの対象都市を指定します。デフォルトはモスクワです。このパラメータには都市名を指定します。数値のYandex Market地域IDとは異なります。
max_price任意- min_priceと組み合わせて使用する場合に、対象のYandexアクションの価格の上限を指定します。ユーザー評価の上限による絞り込みには使用できません。絞り込みには整数が使われ、小数は切り上げられます（145.98は146になります）。
min_price任意- Yandexアクションの価格の下限を指定します。marketでは商品価格、searchではローカルスポットの価格帯を表します。これらの値は対象プラットフォーム上の価格で、APIの利用料金ではありません。絞り込みには整数が使われ、小数は切り捨てられます（39.81は39になります）。
sort任意- Yandexのアクションごとに並び順を指定します。searchではrelevanceまたはdistance、marketではpopularまたはtop_rated、reviewsではnewest（デフォルト）、relevance、top_rated、lowest_ratedを指定できます。値を別のアクションに流用することはできません。指定可能な値:
distancerelevance
Yandexのmarketのパラメータはそれぞれどういう意味ですか？
Yandex Marketで検索語に一致する商品を比較します。価格、評価、レビュー数と購入数、ショップ名とその評価、在庫状況を取得できます。都市はcityまたは数値のregionコードで指定し、デフォルトはモスクワです。注文は行われず、在庫は保証されません。
keyword必須- Yandexアクションの検索語を指定します。searchではローカルスポット、marketではEC商品が対象です。地図の掲載情報と商品カタログは、それぞれ別のデータセットを検索します。
city任意- Yandexのmarketアクションで、対象都市のスラッグ（例：moscow、saint_petersburg）を指定します。許可されたenum値と一致する必要があり、地図検索のlocationの代わりには使用できません。指定可能な値:
chelyabinskkazankrasnodarkrasnoyarskmoscownizhny_novgorodnovosibirskomskpermrostov_on_donsaint_petersburgsamaraufavolgogradvoronezhyekaterinburgYandex Market：都市と商品によって異なる配送条件 — Yandex Marketの公式配送条件では、配送方法、スケジュール、料金は都市と個々の商品に直接ひも付いており、正確な条件は商品ページと購入手続きページに表示されます。これは、最初の商品検索で表示される価格が、配送を含む最終的な合計金額や配送の確約にはならないことを明確にするためのものです。 · 確認日 max_price任意- min_priceと組み合わせて使用する場合に、対象のYandexアクションの価格の上限を指定します。ユーザー評価の上限による絞り込みには使用できません。絞り込みには整数が使われ、小数は切り上げられます（145.98は146になります）。
min_price任意- Yandexアクションの価格の下限を指定します。marketでは商品価格、searchではローカルスポットの価格帯を表します。これらの値は対象プラットフォーム上の価格で、APIの利用料金ではありません。絞り込みには整数が使われ、小数は切り捨てられます（39.81は39になります）。
region任意- Yandexのmarketアクションで、都市の地域コードを数値で指定します。デフォルトは213（モスクワ）です。これは内部の地域識別子で、国コード（RU）ではありません。cityパラメータを明示的に指定すると、この設定より優先されます。
sort任意- Yandexのアクションごとに並び順を指定します。searchではrelevanceまたはdistance、marketではpopularまたはtop_rated、reviewsではnewest（デフォルト）、relevance、top_rated、lowest_ratedを指定できます。値を別のアクションに流用することはできません。指定可能な値:
populartop_rated
Yandexのreviewsのパラメータはそれぞれどういう意味ですか？
Yandex Mapsでビジネスのレビューを1回の呼び出しで最大200件収集します。各レビューには本文、スコア、日付、高評価・低評価の数、オーナーの返信が含まれます。Marketの商品リンクではなく、Mapsの場所リンクまたはビジネスIDを渡してください。sortでlowest_ratedを指定すると、評価の低いレビューを先頭に表示できます。
url必須- reviewsアクションで、Yandex Mapsの場所の完全なURL、またはbusinessIdの文字列を直接指定します。Yandex Marketの商品リンクは指定できません。
language任意- Yandexアクションのフォールバック用インターフェース言語を指定します。デフォルトはsearchではru、reviewsではenです。searchアクションでlangを明示的に渡すと、このパラメータより優先されます。Yandex Maps：レビューの原文とUIの翻訳 — Yandexの公式ドキュメントによると、インターフェースの言語と異なる言語で書かれたレビューには、翻訳とともに原文に戻すオプションが表示される場合があります。そのため、このAPIの言語パラメータを、レビュー原文の言語で直接絞り込むフィルターや、翻訳を保証するものとして扱うことはできません。 · 確認日
sort任意- Yandexのアクションごとに並び順を指定します。searchではrelevanceまたはdistance、marketではpopularまたはtop_rated、reviewsではnewest（デフォルト）、relevance、top_rated、lowest_ratedを指定できます。値を別のアクションに流用することはできません。指定可能な値:
lowest_ratednewestrelevancetop_rated
Yandex 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":"yandex","action":"search","params":{"keyword":"<keyword>"}}'
Yandex APIに関する質問
Yandex APIでは何を取得できますか？
platformをyandexに設定します。現在のカタログには検索、マーケット、レビューが掲載されています。これらのアクション名はそれぞれ異なるYandexのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
Yandexのsearchリクエストを開始するには、どの入力を使用しますか？
Yandexアクションの検索語を指定します。searchではローカルスポット、marketではEC商品が対象です。地図の掲載情報と商品カタログは、それぞれ別のデータセットを検索します。params内のkeywordとして送信してください。
Yandexのsearchはどのフィールドを返しますか？
宣言されたスキーマにはname、text、address、cityが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
Yandexのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。