> For the complete documentation index, see [llms.txt](https://doc.thordata.com/doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.thordata.com/doc/zh/pa-qu/serp-api/cha-xun-can-shu/gu-ge/goole-play.md).

# Goole Play

**SERP  API 谷歌 Search查询参数**

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

<details>

<summary><strong><code>q</code> ，搜索查询(必填)</strong></summary>

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

**示例请求：**

使用`q`：<mark style="color:blue;">pizza</mark>参数的示例

```sh
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"
```

</details>

## 本土化

<details>

<summary><strong><code>gl</code> ，国家(非必填)</strong></summary>

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

完整国家代码支持列表请参阅：[Google官方国家代码表](https://developers.google.com/adwords/api/docs/appendix/geotargeting)

**示例请求：**

查询 `q` ：<mark style="color:blue;">pizza</mark>,`gl`<mark style="color:blue;">：ru</mark>的示例结果

```sh
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"
```

</details>

<details>

<summary><strong><code>hl</code> ，语言(非必填)</strong></summary>

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

完整语言代码支持列表请参阅：[Google官方语言代码表](https://developers.google.com/google-ads/api/docs/start)

**示例请求：**

查询`q` ：<mark style="color:blue;">pizza</mark>,`hl`： <mark style="color:blue;">es</mark>的示例结果

```sh
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"
```

</details>

## 搜索类型

<details>

<summary><strong><code>apps_category</code> ,</strong>应用商店类别<strong>(非必填)</strong></summary>

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

**示例请求：**\
使用参数的示例值 `q` : <mark style="color:blue;">pizza</mark>,**`apps_category`**:ANDROID\_WEAR

```sh
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"
```

</details>

## 分页

<details>

<summary><strong><code>next_page_token</code>,</strong>下一页令牌<strong>(非必填)</strong></summary>

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

**示例请求：**\
使用参数的示例值 `q` : <mark style="color:blue;">pizza</mark>,`next_page_token`:GAME

```sh
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"
```

</details>

<details>

<summary><strong><code>section_page_token</code> ,</strong>部分页面令牌<strong>(非必填)</strong></summary>

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

**示例请求：**\
使用参数的示例值： `q` : <mark style="color:blue;">pizza</mark>,**`section_page_token`**:serpapi\_pagination.next\_page\_token

```sh
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"
```

</details>

<details>

<summary><code>chart</code> <strong>,</strong>图表<strong>(非必填)</strong></summary>

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

**示例请求：**\
使用参数的示例值： `q` : <mark style="color:blue;">pizza</mark>,`chart`:top\_free

```sh
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"
```

</details>

<details>

<summary><code>see_more_token</code> <strong>,</strong>查看更多代币<strong>(非必填)</strong></summary>

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

**示例请求：**\
使用参数的示例值： `q` : <mark style="color:blue;">pizza</mark>,**`section_page_token`**:serpapi\_pagination.next\_page\_token

```sh
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"
```

</details>

## 高级参数

<details>

<summary><code>store_device</code> <strong>,</strong>设备<strong>(非必填)</strong></summary>

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

`phone`- 手机设备（默认）

tablet- 平板电脑设备

`tv`- 电视设备

`chromebook- Chromebook` 设备

`watch`- 手表设备

`car`- 车载设备

**示例请求：**\
使用参数的示例值： `q` : <mark style="color:blue;">pizza</mark>,`store_device`:`phone`

```sh
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"
```

</details>

<details>

<summary><code>age</code> <strong>,</strong>年龄<strong>(非必填)</strong></summary>

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

下拉选择:

`AGE_RANGE1`- 年龄 5 岁以下

`AGE_RANGE2`- 年龄 6-8 岁

`AGE_RANGE3` - 年龄 9-12 岁

**示例请求：**\
使用参数的示例值： `q` : <mark style="color:blue;">pizza</mark>,`age`:AGE\_RANGE1

```sh
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"
```

</details>

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