谷歌搜索API

基础信息

接口说明： 通过API从Google获取实时搜索数据。

请求地址： https://scraperapi.dataify.com/request

请求方式： POST

请求参数

Headers：

参数名称	参数类型	是否必须	描述
token	string	必须	请查看仪表板-账户设置-token管理中查看您的 token。
Authorization	string	必须	查看您的Authorization token參數值。示例："Authorization: Bearer *******************"

Body：

参数名称	参数类型	是否必须	描述
`q`	string	是	定义用于抓取的搜索查询（默认：`q=pizza`）。
`json`	string	否	此参数定义抓取结果的输出格式： `json`=1 表示 JSON 格式， `json`=2 表示同时输出两种格式， `json`=3 表示 HTML 格式。
`google_domain`	string	是	参数定义抓取时使用的域名，默认值为 `google.com`。如需修改或查看完整支持的域名列表，请参考 Google 域名页面。
`gl`	string	否	指定搜索结果的地区/国家设置（支持代码请参考 Google 国家列表）。
`hl`	string	否	设置搜索结果的界面语言完整语言代码列表请参考：Google 语言代码表
`cr`	string	否	使用`\|`分隔符限定搜索结果至特定国家（需搭配 `gl` 参数确保界面语言与内容语言一致） `gl`（界面语言）与 `cr`（国家限制）可同时使用实际效果以 `cr` 参数为优先准则
`lr`	string	否	使用 `lang_XX` 语言代码筛选搜索结果（若同时使用 `hl` 参数，将优先采用本设置）注意： `hl`（界面语言）与 `lr`（语言筛选）可同时使用实际效果以 `lr` 参数为优先准则
`location`	string	否	模拟从精确位置进行的搜索。必须与`uule`配对使用。
`uule`	string	否	此参数会将选定位置以 Base64 编码格式处理，需要与 location 参数搭配使用。所有可用的 uule 参数值可在此下载 CSV 文件
`tbm`	string	否	定义搜索结果类型： `tbm`=isch – 图片 `tbm`=shop – 购物 `tbm`=nws – 新闻 `tbm`=vid – 视频
`start`	string	否	设置搜索结果的分页起始位置。例如： `start`=0（默认值） - 第一页结果 `start`=20 - 第二页结果 `start`=40 - 第三页结果，以此类推
`num`	string	否	此参数设置每页显示的搜索结果数量上限。例如： `num`=20（默认值） - 显示 20 条结果 `num`=50 - 显示 50 条结果，以此类推
`safe`	string	否	此参数用于设置是否过滤成人内容。选项如下： `active`（启用） - 过滤成人内容 `off`（关闭） - 不过滤成人内容
`ludocid`	string	否	此参数用于定义需要抓取的 Google 商家资料（Google My Business）ID（CID），也称为 Google 地点 ID。
`kgmid`	string	否	此参数用于直接获取 Google 知识图谱（Knowledge Graph）中特定条目的加密数据，将覆盖标准搜索参数并返回结构化结果。
`ibp`	string	No	此参数用于控制特定元素的页面渲染与展开效果，例如搭配 `ludocid` 实现知识图谱的扩展搜索交互。
`tbs`	string	否	此参数用于时间/类型筛选（支持复杂条件），例如： `tbs`=qdr:d - 仅显示 24 小时内的内容 `tbs`=qdr:h - 过去 1 小时 `tbs`=qdr:w - 过去 1 周 `tbs`=qdr:m - 过去 1 个月 `tbs`=qdr:y - 过去 1 年
`nfpr`	string	否	此参数用于控制是否禁用搜索关键词的自动校正功能： `nfpr`=1 - 禁用自动校正 `nfpr`=0 - 启用自动校正
`filter`	string	否	此参数用于控制搜索结果的重复内容过滤功能： 1 - 启用去重 0 - 禁用去重

响应示例

{
    "spider_parameter": {
        "engine": "google",
        "q": "pizza"
    },
    "total": {
        "value": "About 2,240,000,000 results (0.30 seconds) "
    },
    "search_metadata": {
        "created_at": "2025-06-21 14:08:06",
        "id": "xxx",
        "url": "https://www.google.com/search?q=pizza"
    },
    "result":{}

参数名称	參數类型	是否必填	描述
`spider_parameter`	object	是	搜索引擎配置
`engine`	string	是	搜索引擎类型
`q`	string	是	搜索关键字
`total`	object	是	搜索结果咨询
`value`	string	是	结果数量和时间
`search_metadata`	object	是	搜索的元数据
`created_at`	string	是	搜索的时间戳
`id`	string	是	唯一任务ID
`url`	string	是	搜索的请求完整URL
`result`	string	是	返回结果