Thordata Docs
简体中文
简体中文
  • 概述
  • 代理
    • 集成教程
      • 住宅代理集成
        • AdsPower
        • BitBrowser
        • ClonBrowser
        • Hubstudio
        • Playwright
        • Puppeteer
        • Selenium
        • Ghost Browser
        • SwitchyOmega
        • FoxyProxy
        • Chrome
        • Edge
        • MuLogin
        • Incogniton
      • ISP代理集成
        • AdsPower
        • BitBrowser
        • ClonBrowser
        • Hubstudio
        • Ghost Browser
        • SwitchyOmega
        • FoxyProxy
        • Chrome
        • Edge
      • 数据中心代理集成
        • AdsPower
        • BitBrowser
        • ClonBrowser
        • Hubstudio
        • Ghost Browser
        • SwitchyOmega
        • FoxyProxy
        • Chrome
        • Edge
      • 无限代理集成
        • AdsPower
        • BitBrowser
        • ClonBrowser
        • Hubstudio
        • Ghost Browser
        • SwitchyOmega
        • FoxyProxy
        • Chrome
        • Edge
    • 住宅代理
      • 入门指南
      • 端点生成器
        • 账密认证
        • IP白名单
          • 国家条目提取
            • 国家/地区入口节点
          • API链接
      • 账户
      • 基本查询
      • 位置设置
        • 国家/地区
        • 城市
        • 州
      • 会话控制
      • 协议
      • 国家/地区列表
      • CDKEY生成与兑换
    • ISP代理
      • 入门指南
    • 数据中心代理
      • 入门指南
    • 无限代理服务器
      • 端点生成器
        • 账密认证
        • IP白名单
          • 国家条目提取
          • API链接
      • 账户
      • 国家/地区列表
  • 爬取
    • SERP API
      • SERP API简介
      • 快速入门
      • 发送您的第一次请求
      • 查询参数
        • 谷歌
        • Bing
        • Yandex
        • DuckDuckGo
      • 常见问题解答
  • WEB Scraper API
    • 入门指南
    • API 请求构建器
    • 抓取参数说明
    • Webhook 集成
    • Amazon S3 集成
  • Universal Scraping API
    • 入门指南
    • 配置
    • 参数说明
  • 免费工具
    • 谷歌扩展程序
      • 使用教程
  • 有用的链接
    • 仪表板中心
  • 常见问题
    • 产品问题
      • 我该如何选择合适的代理套餐?
      • 如何定位特定的国家/地区?
      • 如何定位特定的城市?
      • 什么是无限代理?
      • 为什么在指纹浏览器中使用我们的代理,无法达到您的理想使用效果?
        • 1. 代理完全不生效
        • 2. 您所使用的其他检测渠道检测结果与Thordata后台提取的国家不一致
        • 3. 您所访问的目标网站检测结果与Thordata后台提取的国家不一致
        • 4. 代理生效,但代理的归属地检测结果是随机的
        • 5. 使用白名单的方式,连接失败
    • 付款问题
      • 支持哪些支付方式?
      • 购买错套餐怎么办?
      • 是否提供付费服务退款?
      • 付款后,收到代理余额或激活我的帐户需要多长时间?
  • 支持
    • 联系我们
Powered by GitBook
On this page
  • 本土化
  • 地理位置
  • 搜索类型
  • 分页
  • 高级参数

Was this helpful?

  1. 爬取
  2. SERP API
  3. 查询参数

谷歌

SERP API 谷歌查询参数

使用 Thordata的 SERP API 配置谷歌搜索查询,包括本地化参数、地理位置、分页、以及“高级参数”输出选项。

q ,搜索查询(必填)

定义用于数据抓取的搜索查询(默认值:q=pizza)。支持任何语言的任意关键词。

示例请求:

使用q:pizza参数的示例

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1\"}"

本土化

url,域名(非必填)

定义用于数据抓取的搜索引擎域名(默认值:google.com)。

您可在系统中修改此参数或参考Google域名页面获取完整支持的域名列表。

示例请求:

查询 q :pizza ,url :google.co.ao的示例结果

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://www.google.co.ao/search?q=pizza^&json=1\"}"
gl ,国家(非必填)

指定搜索结果的定位国家/地区(默认值:us)。采用两位字母国家代码(如:us-美国,ru-俄罗斯,uk-英国)。

完整国家代码支持列表请参阅:Google官方国家代码表

示例请求:

查询 q :pizza,gl:ru的示例结果

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://www.google.com/search?q=pizza^&gl=ru^&json=1\"}"
hl ,语言(非必填)

设置搜索结果的界面语言(默认值:en)。采用标准语言代码格式(如:en-英文,es-西班牙文,zh-CN-简体中文)。

完整语言代码支持列表请参阅:Google官方语言代码表

示例请求:

查询q :pizza,hl: es的示例结果

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&hl=es\"}"
cr,设置多个国家/地区(非必填)

限制结果至特定国家,使用 | 作为分隔符(例如:countryFR|countryDE)。可与 gl 参数配合使用以确保界面/内容语言一致。

gl 和 cr 参数可组合使用,但实际效果以 cr 参数为优先。

示例请求:

查询q : pizza,cr: countryFR|countryDE的示例结果

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&cr=countryFR|countryDE\"}"
lr,设置多语言(非必填)

使用 lang_XX 代码(如 lang_fr|lang_de)按语言筛选结果。若同时使用 hl 参数,此参数将覆盖 hl。

hl 和lr可同时使用,但实际效果以 lr 为优先。

示例请求:

查询 q : pizza,lr: lang_en|lang_fr的示例结果

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{"url": "https://www.google.com/search?q=pizza^&json=1^&lr=lang_en|lang_fr"}"

地理位置

location,地理位置(非必填)

模拟从精确位置发起搜索,必须与 uule 参数搭配使用。若未指定,则可能采用代理服务器的地理位置。

示例请求:

查询 q : pizza,location:India,uule:w+CAIQICIFSW5kaWE的示例结果

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&location=India^&uule=w+CAIQICIFSW5kaWE\"}"
uule ,UULE(非必填)

使用 Base64 编码目标地理位置,需与 location 参数配合使用。

示例请求:

查询 q : pizza,location:India,uule:w+CAIQICIFSW5kaWE的示例

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&location=India^&uule=w+CAIQICIFSW5kaWE\"}"

搜索类型

tbm ,搜索搜索类型(非必填)

定义搜索结果类型:

  • tbm=isch – 图片

  • tbm=shop – 购物

  • tbm=nws – 新闻

  • tbm=vid – 视频

示例请求:

查询 q : pizza,tbm:shop的示例

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&tbm=shop\"}"

分页

start ,结果偏移量(非必填)

设置搜索结果分页起点(如 “start=30” 表示跳过前 30 条结果,从第 31 条开始显示)。

示例请求:

查询 q : pizza,start:30的示例

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&start=30\"}"
num ,每页结果数(非必填)

该参数定义了搜索结果每页返回的最大数。例如:10是返回10个结果。

示例请求:

查询 cq : pizza,num:20的示例

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&num=20\"}"
safe ,安全(非必填)

该参数定义了搜索结果是否屏蔽成人内容。您可设置为 active 或者 off ,通常情况下,Google会对露骨内容进行模糊处理。

示例请求:

查询 q : pizza,safe:active的示例

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&safe=active\"}"

高级参数

ludocid ,Google 地点 ID(非必填)

参数定义您要抓取的谷歌我的业务列表的标识(CID)。也称为谷歌地点标识。

示例请求:

查询 q : pizza,ludocid:14389889685039125943的示例

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://www.google.com/search?q=Google^&json=1^&ludocid=14389889685039125943\"}"
kgmid ,Google 知识图谱 ID(非必填)

kgmid 参数用于直接调用 Google 知识图谱中特定条目的加密数据,覆盖常规搜索参数并返回结构化结果。

示例请求:

查询 q : pizza,kgmid:/m/0d6lp的示例

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://www.google.com/search?q=Google^&json=1^&kgmid=/m/0d6lp\"}"
ibp ,Google 元素渲染(非必填)

用于控制特定元素(如带ludocid的知识图谱扩展搜索)的布局渲染和展开效果

示例请求:

查询 q : pizza,ibp:new的示例

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&ibp=new\"}"
tbs ,高级搜索条件(非必填)

时间/类型筛选(支持复杂条件),比如tbs=qdr:d qdr:d=24小时内的内容;再比如tbs=sur:f,表示结果仅展示图片

示例请求:

查询 q : pizza,tbs:sur:f的示例

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&tbs=sur:f\"}"
nfpr ,排除自动更正结果(非必填)

定义是否禁用自动纠正拼写,比如:nfpr=1 ,搜索“googl”不自动纠正为“google”

示例请求:

查询 q : pizza,nfpr:sur:f的示例

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&nfpr=1\"}"
filter ,结果筛选(非必填)

定义去重结果: 1 (启用), 0 (禁用).

示例请求:

查询 q : pizza,filter:1的示例

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&filter=1\"}"

如果您需要更多帮助,请通过邮箱support@thordata.com联系我们。

Previous查询参数NextBing

Last updated 13 hours ago

Was this helpful?