文档Scraping APIGoogle Search端点

Google Search API 端点

选择一种 Google 搜索类型，并使用 Google Search API 发送请求。本指南基于快速入门编写，涵盖了五种搜索类型，并在 Scrapeless API 参考文档中设有专门条目。

所有五种类型均使用相同的 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 对象。

选择搜索类型

搜索类型input.tbm请求输入
Google 搜索省略q 中的搜索查询
Google 图片ischq 中的图片搜索查询
Google 本地lclq 中的本地搜索查询
Google 视频vidq 中的视频搜索查询
Google 购物shopq 中的购物搜索查询
Google 网页webq 中的网页搜索查询
Google 招聘jobsq 中的招聘搜索查询
Google 新闻nwsq 中的新闻搜索查询
Google 短视频svidq 中的短视频搜索查询

这些是同一端点的不同搜索模式。在切换模式时，请保持 HTTP URL、身份验证标头和 actor 不变。

Google 搜索

进行常规网页搜索时，请省略 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 搜索参考文档

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"
  }
}'

若需定位到城市级别，请在 input 中添加 location，例如 "Austin, Texas, United States"。请使用 location 或 uule 其中之一，切勿在同一请求中同时使用两者。

对于本地搜索的分页，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,
    "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,
    "tbm": "shop"
  }
}'

Google 购物参考文档

通用搜索控制参数

在 input 中设置以下字段：

参数用途
q必填的搜索查询。
gl搜索国家/地区，例如 us。
hl搜索语言，例如 en。
google_domainGoogle 域名；默认为 google.com。
location搜索来源地，建议指定到城市级别。
uule编码后的 Google 位置参数；与 location 互斥。
start结果偏移量。网页搜索使用 0、10、20，依此类推。
tbs高级搜索过滤器。

有关完整的参数说明，请参阅 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 搜索示例并非图片、本地、视频或购物的架构模板。

相关文档

快速入门介绍