SERP API Yandex查询参数
使用 dataify的 SERP API 配置Yandex搜索查询,包括本土化、地理位置和分页等参数输出选项。
q ,搜索查询(必填)定义用于数据抓取的搜索查询(默认值:q=pizza)。支持任何语言的任意关键词。
示例请求:
使用q:pizza参数的示例
curl -X POST https://scraperapi.dataify.com/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=yandex" \
-d "text=pizza" \
-d "json=1"
yandex_domain ,域名(非必填)该参数定义了爬取时使用的域名,默认值为 yandex.com
示例请求:
查询 q : pizza,url:yandex.com.tr的示例结果
curl -X POST https://scraperapi.dataify.com/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=yandex" \
-d "text=pizza" \
-d "yandex_domain=yandex.com" \
-d "json=1"
lang ,语言(非必填)该参数定义了爬取时搜索结果使用的语言,默认值为 en 。它是一个由两个字母组成的语言代码(例如,en, ru, es)。
详情列表: Yandex Language Codes
示例请求:
查询 q : pizza,lang:en的示例结果
curl -X POST https://scraperapi.dataify.com/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=yandex" \
-d "text=pizza" \
-d "json=1" \
-d "lang=en"
lr ,位置(非必填)指定搜索结果的地区(Yandex 区域数字 ID),优先级高于 IP 定位。注意:传文本名称(如 India/Moscow)实测返回 400,请使用数字区域 ID。
示例请求:
查询 q : pizza,lr:84的示例结果
curl -X POST https://scraperapi.dataify.com/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=yandex" \
-d "text=pizza" \
-d "json=1" \
-d "lr=84"
rstr ,位置严格检查(非必填)强制结果匹配指定地区(lr)或启用安全搜索过滤,取值透传。注意:rstr=family 实测返回 400 已失效,可用 strict/off 等。
示例请求:
查询 q : pizza,rstr:true的示例结果
curl -X POST https://scraperapi.dataify.com/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=yandex" \
-d "text=pizza" \
-d "json=1" \
-d "rstr=true"
p ,页码(非必填)分页控制(从 p=0 开始),需配合每页条数参数使用。
示例:p=2,获取第3页的结果。
示例请求:
查询 q : pizza,p:2的示例结果
curl -X POST https://scraperapi.dataify.com/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=yandex" \
-d "text=pizza" \
-d "json=1" \
-d "p=2"
within ,时间周期(非必填)时间/域限制:
时间范围过滤,取值透传给 Yandex(旧文档「7天=过去7天」的写法已失效,实测返回 400;90、2w、1m 等可正常传入)。
示例请求:
查询 q : pizza,within:90的示例结果
curl -X POST https://scraperapi.dataify.com/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=yandex" \
-d "text=pizza" \
-d "json=1" \
-d "within=90"