Goole Play

SERP API 谷歌 Search查询参数

用Thordata的SERP API配置谷歌搜索查询，支持本地化参数、应用商店分类、分页及高级参数输出选项的定制功能。

q ，搜索查询(必填)

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

示例请求：

使用q：pizza参数的示例

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_play" \
 -d "q=pizza" \
 -d "json=1"

本土化

gl ，国家(非必填)

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

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

示例请求：

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

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_play" \
 -d "q=pizza" \
 -d "gl=ru" \
 -d "json=1"

hl ，语言(非必填)

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

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

示例请求：

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

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_play" \
 -d "q=pizza" \
 -d "json=1" \
 -d "hl=es"

搜索类型

apps_category ,应用商店类别(非必填)

参数定义了应用商店类别。

示例请求： 使用参数的示例值 q : pizza,apps_category:ANDROID_WEAR

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_play" \
 -d "q=pizza" \
 -d "json=1" \
 -d "apps_category=ANDROID_WEAR"

分页

next_page_token,下一页令牌(非必填)

此参数定义下一页标记。它用于检索下一页结果。它不应与 section_page_token、see_more_token和 chart参数一起使用。

示例请求： 使用参数的示例值 q : pizza,next_page_token:GAME

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_play" \
 -d "q=pizza" \
 -d "json=1" \
 -d "next_page_token=GAME"

section_page_token ,部分页面令牌(非必填)

此参数定义用于检索各个部分分页结果的部分页面标记。此参数是see_more_token的更安全版本，在可分页的每一行中均有存在。它不应与 next_page_token、 see_more_token和 chart参数一起使用。

示例请求： 使用参数的示例值： q : pizza,section_page_token:serpapi_pagination.next_page_token

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_play" \
 -d "q=pizza" \
 -d "json=1" \
 -d "section_page_token=serpapi_pagination.next_page_token"

chart ,图表(非必填)

参数用于显示热门图表。它最多可返回50结果。每个商店包含不同的图表，需要不同的值来检索结果。要获取特定图表的值，您可以使用我们的 Google Play 应用商店 API JSON 输出：（chart_options[index].value例如chart=topselling_free）。它不应与 section_page_token、 see_more_token和 next_page_token参数一起使用

示例请求： 使用参数的示例值： q : pizza,chart:top_free

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_play" \
 -d "q=pizza" \
 -d "json=1" \
 -d "chart=top_free"

see_more_token ,查看更多代币(非必填)

该参数定义了用于检索各个部分分页结果的“查看更多”令牌。该令牌通常位于下一页结果中。它不应与 section_page_token、 next_page_token和 chart参数一起使用。

示例请求： 使用参数的示例值： q : pizza,section_page_token:serpapi_pagination.next_page_token

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_play" \
 -d "q=pizza" \
 -d "json=1" \
 -d "see_more_token=similar_apps"

高级参数

store_device ,设备(非必填)

参数定义了用于排序结果的设备。此参数不能与apps_category或q参数一起使用。可用选项:

phone- 手机设备（默认）

tablet- 平板电脑设备

tv- 电视设备

chromebook- Chromebook 设备

watch- 手表设备

car- 车载设备

示例请求： 使用参数的示例值： q : pizza,store_device:phone

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_play" \
 -d "q=pizza" \
 -d "json=1" \
 -d "store_device=phone"

age ,年龄(非必填)

参数定义了年龄子类别。age_works且仅应与 apps_category=FAMILY(儿童应用)一起使用

下拉选择:

AGE_RANGE1- 年龄 5 岁以下

AGE_RANGE2- 年龄 6-8 岁

AGE_RANGE3 - 年龄 9-12 岁

示例请求： 使用参数的示例值： q : pizza,age:AGE_RANGE1

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_play" \
 -d "q=pizza" \
 -d "json=1" \
 -d "age=AGE_RANGE1"

如果您需要更多帮助，请通过邮箱[email protected]联系我们。