Goole Play

SERP API 谷歌查詢參數

使用 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 ,年龄(非必填)

該參數用於定義年齡子類別，僅在 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] 聯繫我們。