プラットフォームの稼働状況
- 24時間の稼働状況
- 正常
過去30日間
利用可能な機能
SERPの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
検索search | Web検索を実行し、タイトル、URL、スニペット、掲載順位、公開日を含むランク付けされた結果を取得します。画像やサブリンクがある場合はそれも返されます。countryとlanguageは優先設定であり、すべての結果が一致することを保証するものではありません。ページ全体は取得されず、published_atは欠落していたり不正確だったりする場合があります。 | 1,000リクエストあたり$1.39 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
SERPの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
search検索 Web検索を実行し、タイトル、URL、スニペット、掲載順位、公開日を含むランク付けされた結果を取得します。画像やサブリンクがある場合はそれも返されます。 | keyword | country, language | Sync配信 | カタログ値：maxLimit=10。最終的な行数とみなす前に、アクションの注記を確認してください。より大きいlimitも指定できますが、10が上限として適用されます。 | 1,000リクエストあたり$1.39 | title · url · text · rank · published_at · image_url · sub_links |
SERPのsearchのパラメータはそれぞれどういう意味ですか？
Web検索を実行し、タイトル、URL、スニペット、掲載順位、公開日を含むランク付けされた結果を取得します。画像やサブリンクがある場合はそれも返されます。countryとlanguageは優先設定であり、すべての結果が一致することを保証するものではありません。ページ全体は取得されず、published_atは欠落していたり不正確だったりする場合があります。
keyword必須- Web検索のクエリ式を指定します。結果のタイトル、URL、スニペットを返します。検索結果のページ全文の取得や、プラットフォーム名による絞り込みは行いません。Google：検索スニペットと参照元Webページのテキストの違い — Googleはスニペットを検索結果に表示される説明や要約と定義しており、スニペットは検索クエリに応じて動的に変わる場合や、ページのメタディスクリプションから生成される場合があると説明しています。このアクションが返すテキストは対象ページの全文ではありません。事実を引用する際は、検証済みの参照元ページを直接確認する必要があります。 · 確認日
country任意- usなどのコードを使って、検索結果で優先する国または地域を設定します。影響するのは地理的な関連性で、呼び出し元サーバーの所在地ではありません。また、すべての結果がその国のものになるとは限りません。
language任意- 検索インターフェースと結果の言語設定を指定します（例：en、zh-cn）。返されるページの内容は翻訳されません。
SERP 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":"web","action":"search","params":{"keyword":"<keyword>"}}'
SERP APIに関する質問
SERP APIでは何を取得できますか？
platformをwebに設定します。現在のカタログには検索が掲載されています。これらのアクション名はそれぞれ異なるSERPのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
SERPのsearchリクエストを開始するには、どの入力を使用しますか？
Web検索のクエリ式を指定します。結果のタイトル、URL、スニペットを返します。検索結果のページ全文の取得や、プラットフォーム名による絞り込みは行いません。params内のkeywordとして送信してください。
SERPのsearchはどのフィールドを返しますか？
宣言されたスキーマにはtitle、text、rank、published_atが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
SERPのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。