ドキュメント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キーに置き換えてください。actorとinput` を含むJSONオブジェクトを1つ送信します。

検索タイプの選択

検索タイプinput.tbmリクエスト入力
Google Search省略q 内の検索クエリ
Google Imagesischq 内の画像検索クエリ
Google Locallclq 内のローカル検索クエリ
Google Videosvidq 内の動画検索クエリ
Google Shoppingshopq 内のショッピング検索クエリ
Google Webwebq 内のウェブ検索クエリ
Google Jobsjobsq 内の求人情報検索クエリ
Google Newsnwsq 内のニュース検索クエリ
Google Short Videossvidq 内のショート動画検索クエリ

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

Google Search

通常のウェブ検索では 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、およびクエリに依存するその他のセクションを含むウェブ検索のレスポンスが含まれています。すべてのクエリがすべてのセクションを返すとは限らない点に注意してください。

Google Search リファレンス

Google Images

画像検索をリクエストするには、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 Images リファレンス

Google Local

ローカル検索をリクエストするには、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"
  }
}'

都市レベルのターゲティングを行う場合は、input 内に location を追加します（例："Austin, Texas, United States"）。location と uule のいずれか一方のみを使用し、1つのリクエストで両方を指定しないでください。

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

Google Local リファレンス

Google Videos

“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,
    "tbm": "vid"
  }
}'

Google Videos リファレンス

Google Shopping

“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,
    "tbm": "shop"
  }
}'

Google Shopping リファレンス

共通の検索制御パラメータ

これらのフィールドは input 内で設定します：

パラメータ目的
q必須の検索クエリ。
gl検索対象国（例：us）。
hl検索言語（例：en）。
google_domainGoogleドメイン。デフォルトは google.com。
location検索の起点。都市レベルでの指定が推奨されます。
uuleエンコードされたGoogleロケーション。location と排他的（同時に使用不可）。
start結果のオフセット。ウェブ検索では 0、10、20 などを使用します。
tbs詳細検索フィルター。

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

結果の取得

  • 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に置き換えてください。完全なワークフローについては、Results and Polling を参照してください。

レスポンスのセクションは検索タイプとクエリによって異なります。専用API仕様では現在、成功時のレスポンスに対して汎用オブジェクトを宣言しています。通常のGoogle Searchの例は、Images、Local、Videos、またはShoppingのスキーマではありません。

関連ドキュメント

クイックスタート紹介