谷歌搜索API

基础信息

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

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

请求方式： POST

请求参数

Headers：

参数名称	参数类型	是否必须	描述
Authorization	string	必须	固定格式：Authorization: Bearer <你的token>。token 在仪表板 → 设置 → Token管理获取。不支持自定义 token 请求头。

Body：

参数名称	参数类型	是否必须	描述
engine	string	是	目标搜索引擎，固定为 google。注：传 tbm=isch/shop/nws/vid 时 Google 引擎内部路由为对应子引擎。
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	否	此参数用于控制特定元素的页面渲染与展开效果，例如搭配 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 - 禁用去重

响应示例

{
    "code": 200,
    "cache_status": false,
    "spider_parameter": {
        "engine": "google",
        "device": "desktop",
        "domain": "https://www.google.com/",
        "q": "pizza",
        "render_js": false,
        "render_png": false,
        "ai_overview": false
    },
    "search_metadata": {
        "id": "ihtpdp1d5r7yltj5adx0gjahj24agw8d",
        "spider_url": "https://www.google.com/search?q=pizza",
        "total_time_taken": 1.9896,
        "created_at": "2026-06-22 15:05:03",
        "processed_at": "2026-06-22 15:05:05",
        "status": "Success"
    },
    "search_information": {
        "total_results": "About 1260000000 results",
        "query_displayed": "pizza",
        "organic_results_state": "Results for exact spelling"
    },
    "organic": [
        {
            "title": "Pizza Hut",
            "position": 1,
            "display_link": "https://www.pizzahut.com",
            "link": "https://www.pizzahut.com/",
            "description": "Starting at $7. ..."
        }
    ],
    "knowledge": {},
    "snack_pack": [],
    "pagination": {},
    "related": []
}

参数名称	参数类型	是否必返	描述
code	int	是	业务状态码，200 表示成功
cache_status	bool	是	是否命中缓存
spider_parameter	object	是	实际生效的请求参数：engine/device/domain/q/render_js/render_png/ai_overview
search_metadata	object	是	搜索元数据
id	string	是	唯一任务 ID
spider_url	string	是	实际请求的完整 URL
status	string	是	任务状态（Success 等）
created_at	string	是	创建时间
processed_at	string	是	处理完成时间
total_time_taken	number	是	总耗时（秒）
search_information	object	是	搜索信息
total_results	string	是	结果总数文案（如 "About 1260000000 results"）
query_displayed	string	是	实际展示的查询词
organic	array	是	自然搜索结果列表（元素含 title/position/link/display_link/description）
knowledge	object	否	知识图谱结果（按查询返回）
snack_pack	array	否	本地商户包（按查询返回）
snack_pack_map	object	否	本地地图（按查询返回）
google_ai_overview	object	否	AI 概览（需 ai_overview=true，按查询返回）
pagination	object	否	分页信息
related	array	否	相关搜索（按查询返回）