Google 搜索

抓取实时的 Google 搜索结果，并获取干净、结构化的 JSON 数据——包括自然搜索结果、广告、相关搜索、知识图谱等。

Actor

scraper.google.search

常用参数

在 input 对象中传递。完整列表请参阅 API 参数。

参数	是否必需	描述
`q`	true	搜索查询词。支持高级运算符，如 `inurl:`、`site:`、`intitle:`。
`gl`	false	搜索的国家/地区双字母代码（例如 `us`、`uk`、`fr`）。
`hl`	false	搜索的语言双字母代码（例如 `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()

入门