谷歌
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联系我们。
Last updated
Was this helpful?