ドキュメントScraping APIGoogle Searchエンドポイント

Google Search API エンドポイント

Google検索タイプを選択し、Google Search APIを使用してそのリクエストを送信します。このガイドは クイックスタート に基づいており、Scrapeless APIリファレンスで専用のエントリを持つ5つの検索タイプについて説明しています。

すべての5つは同じHTTPエンドポイントとactor scraper.google.searchを使用します。 input.tbm 値が検索タイプを選択します。

リクエストと認証

POST https://api.scrapeless.com/api/v1/scraper/request
x-api-token: YOUR_API_KEY
Content-Type: application/json

YOUR_API_KEY をご自身のScrapeless APIキーに置き換えてください。JSONオブジェクトを1つ送信し、その中に actor と inputを含めてください。

検索タイプを選択

検索タイプinput.tbmリクエスト入力
Google Search省略で検索クエリ q
Google画像検索isch画像検索クエリをで q
Googleローカルlclローカル検索クエリをで q
Google動画検索vid動画検索クエリをで q
Googleショッピングshopショッピング検索クエリをで q

これらは1つのエンドポイントの検索モードです。モードを切り替える際は、HTTP URL、認証ヘッダー、およびactorを変更しないでください。

Google Search

通常のWeb検索の場合は tbm を省略してください。

curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
  --header 'x-api-token: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "actor": "scraper.google.search",
  "input": {
    "q": "coffee",
    "hl": "en",
    "gl": "us"
  }
}'

クイックスタートには、 organic_results、 pagination、および他のクエリ依存のセクションを含むWeb検索のレスポンスが含まれています。すべてのクエリがすべてのセクションを返すとは限りません。

Google Searchリファレンス

Google画像検索

画像検索をリクエストするには、 tbm を isch に設定してください。以下のリクエストはデフォルトのGoogleドメインを使用しています。

curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
  --header 'x-api-token: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "actor": "scraper.google.search",
  "input": {
    "q": "Apple Iphone16",
    "hl": "en",
    "gl": "us",
    "tbm": "isch"
  }
}'

Google画像検索リファレンス

Googleローカル

ローカル検索をリクエストするには、 tbm を lcl に設定してください。

curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
  --header 'x-api-token: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "actor": "scraper.google.search",
  "input": {
    "q": "coffee shops",
    "hl": "en",
    "gl": "us",
    "tbm": "lcl"
  }
}'

都市単位で対象を指定する場合は、 location を input内に追加し、 "Austin, Texas, United States"などの値を設定します。指定するのは location または uuleのいずれかであり、1つのリクエストに両方を含めることはできません。

ローカル検索のページネーションでは、 start は20の倍数である必要があります： 0、 20、 40など。

Googleローカルリファレンス

Google動画検索

tbm を vidに設定してください。この例では、専用のAPIリファレンスに示されているリクエストフィールドが保持されています。

curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
  --header 'x-api-token: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "actor": "scraper.google.search",
  "input": {
    "engine": "google.search",
    "q": "Coffee",
    "google_domain": "google.com",
    "start": 0,
    "num": 10,
    "tbm": "vid"
  }
}'

Google動画検索リファレンス

Googleショッピング

tbm を shopに設定してください。この例では、専用のAPIリファレンスに示されているリクエストフィールドが保持されています。

curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
  --header 'x-api-token: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "actor": "scraper.google.search",
  "input": {
    "engine": "google.search",
    "q": "Coffee",
    "google_domain": "google.com",
    "start": 0,
    "num": 10,
    "tbm": "shop"
  }
}'

Googleショッピングリファレンス

共通の検索制御

以下のフィールドを input内に設定してください：

パラメータ目的
q必須の検索クエリ。
gl検索対象国（例： us）
hl検索言語（例： en）
google_domainGoogleドメイン。デフォルトは google.comです。
location検索元。可能であれば都市レベルで指定してください。
uuleエンコードされたGoogleロケーション。 locationとは相互に排他的です。
start結果のオフセット。Web検索では 0、 10、 20などを使用します。
num要求される最大結果数。
tbs高度な検索フィルター。

パラメータリファレンスでは、 num がレイテンシを増加させたり、特殊な結果タイプに影響を与える可能性があると警告しています。必要でない限り省略してください。要求した件数が、実際にその数の結果が返されることを保証するものではありません。前述のVideosおよびShoppingの例では、ドキュメント化された 10の値が保持されています。

完全なパラメータの説明については、 Google Searchパラメータ を参照してください。現在サポートされているデバイスはデスクトップです。

結果を読み取る

  • HTTP 200：JSONの結果を読み取ります。
  • HTTP 201： taskId を保存し、結果エンドポイントを使って既存のタスクを取得します。
curl --request GET 'https://api.scrapeless.com/api/v1/scraper/result/YOUR_TASK_ID' \
  --header 'x-api-token: YOUR_API_KEY'

YOUR_TASK_ID を返されたIDに置き換えてください。完全なワークフローについては、 結果の取得とポーリング を参照してください。

レスポンスのセクションは検索タイプとクエリによって異なります。専用のAPI仕様では、成功したレスポンスに対して現在一般的なオブジェクトが宣言されています。通常のGoogle Searchの例は、画像、ローカル、動画、ショッピングのスキーマではありません。

関連ドキュメント

クイックスタート紹介