Google検索

リアルタイムのGoogle検索結果をスクレイピングし、オーガニック結果、広告、関連検索、ナレッジグラフなどを含むクリーンで構造化されたJSONデータを取得します。

Actor

scraper.google.search

共通パラメータ

input オブジェクト内で渡されます。完全なリストについては、APIパラメータを参照してください。

パラメータ	必須	説明
`q`	true	検索クエリ。`inurl:`、`site:`、`intitle:` などの高度な演算子をサポートします。
`gl`	false	検索用の2文字の国コード（例：`us`、`uk`、`fr`）。
`hl`	false	検索用の2文字の言語コード（例：`en`、`es`、`fr`）。
`google_domain`	false	使用するGoogleドメイン。デフォルトは `google.com` です。
`location`	false	検索の発信地（都市レベルを推奨）。
`start`	false	ページネーション用の結果オフセット（`0`、`10`、`20`、…）。

リクエスト例

curl '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",
        "google_domain": "google.com"
    }
}'

import { Scrapeless } from '@scrapeless-ai/sdk';
 
const client = new Scrapeless({
  apiKey: 'YOUR_API_KEY'
});
 
client.deepserp.createTask({
    actor: "scraper.google.search",
    input: {
        q: "coffee",
        gl: "us",
        hl: "en",
        google_domain: "google.com"
    }
}).then((result) => {
    console.log(result);
  })
  .catch((error) => {
    console.error('Error:', error);
  });

import json
import requests
 
def send_request():
    host = "api.scrapeless.com"
    url = f"https://{host}/api/v1/scraper/request"
    token = "your_api_key"
 
    headers = {
        "x-api-token": token,
        "Content-Type": "application/json"
    }
 
    json_payload = json.dumps({
        "actor": "scraper.google.search",
        "input": {
            "q": "coffee",
            "gl": "us",
            "hl": "en",
            "google_domain": "google.com"
        }
    })
 
    response = requests.post(url, headers=headers, data=json_payload)
 
    if response.status_code != 200:
        print("Error:", response.status_code, response.text)
        return
 
    print("body", response.text)
 
if __name__ == "__main__":
    send_request()

はじめる