Google Play 產品 API

API 詳情

請求端點 GET https://serpapi.abcproxy.com/search

**說明 **

我們的 Google Play 產品 API 允許您從 Google Play 產品頁面抓取結果。此 API 可透過以下端點存取:/search?engine=google_play_product

使用者可以使用 GET 請求查詢以下網址:https://serpapi.abcproxy.com/search?engine=google_play_product。請前往 工作臺 查看即時互動演示


請求方式

HTTP 請求範例

curl -X GET "https://serpapi.abcproxy.com/search" \
  -d "engine=google_play_product" \
  -d "product_id=com.google.android.youtube" \
  -d "no_cache=false" \
  -d "api_key=YOUR_API_KEY"

API 參數說明

搜尋參數

參數名稱
類型
必填項
說明
範例

product_id

字符串

定義您想在 Google Play 應用程式商店中搜尋的產品 ID。

com.google.android.youtube

地區與語言設定

參數名稱
類型
必填項
說明
範例

gl

字符串

指定用於 Google Play 搜尋的國家,使用兩碼國家代碼,例如 us(美國,預設值)、uk(英國)、fr(法國)。完整支援國家清單可參見:Google Play Countries,也可前往 Google countries page 查詢代碼。

us

hl

字符串

指定用於 Google Play 搜尋的語言,使用兩碼語言代碼,例如 en(英文,預設值)、es(西班牙文)、fr(法文)。完整支援語言清單請見 Google languages page

en

Google Play分類

參數名稱
類型
必填項
說明
範例

store

字符串

定義欲查詢的 Google Play 商店類型。共支援五種類型:apps(預設)、moviestvbooksaudiobooks

apps

電視商店參數

參數名稱
類型
必填項
說明
範例

season_id

字符串

定義欲查詢的影集季節 ID。此參數僅在 store 參數設定為 tv 時使用。

store=tv

查看參數

參數名稱
類型
必填項
說明
範例

all_reviews

字符串

是否擷取該產品的所有評論。可設為 truefalse(預設)。

true

platform

字符串

用來篩選評論的平台類型。 可選值: phone(手機,預設)、 tablet(平板)、 watch(智慧手錶)、 chromebook(Chromebook)、 tv(電視)。

-

rating

字符串

根據評分篩選評論。 可設為: 1:1 星、 2:2 星、 3:3 星、 4:4 星、 5:5 星。 此參數僅在 all_reviews=true 時使用。

-

sort_by

字符串

根據條件排序評論。 可設為: 1:最相關(預設)、 2:最新、 3:評分。

-

num

字符串

設定要回傳的評論數量上限。例如 40(預設)會回傳 40 筆評論,80 回傳 80 筆,最多支援回傳 199 筆。 此參數僅在 all_reviews=true 時使用。

40

next_page_token

字符串

下一頁的分頁代碼,用於載入更多評論。

-

SerpApi 專屬參數

參數名稱
類型
必填項
說明
範例

engine

字符串

設定為 google_play_product 以使用 Google Play Product API 引擎。

google_play_product

no_cache

布爾值

是否強制 SerpApi 即時重新擷取資料,即使有快取結果也不使用。預設為 false(允許使用快取)。若設為 true,則必定重新擷取。快取有效期為 1 小時,且使用快取不計費。

trueorfalse

api_key

字符串

指定要使用的 SerpApi 私密金鑰

-


響應

成功回應(HTTP 200)

響應機构

響應欄位

Field
Type
Description

search_metadata

對象

包含搜尋的時間與狀態資訊

search_parameters

對象

包含查詢參數與搜尋上下文

developer_contact

對象數組

開發者聯絡資訊

similar_results

對象數組

類似應用結果

about_this_app

對象數組

關於此應用

data_safety

對象數組

資料安全資訊

ratings

對象數組

評分資料

product_info

對象數組

產品資訊

badges

對象數組

標章

reviews

對象數組

使用者評論


錯誤回應

常見錯誤碼與說明

HTTP 狀態碼
錯誤碼
說明

200

400

API 金鑰不能為空

200

401

參數錯誤

200

402

API 金鑰錯誤

200

403

餘額不足

200

404

扣款失敗

200

405

記錄使用次數失敗

200

406

不支援的搜尋引擎

200

407

網路錯誤

200

408

找不到檔案

200

409

限制參數錯誤

200

410

建立 URL 錯誤

200

411

查詢歷史記錄失敗

200

412

找不到 JSON 結果

200

413

擷取 HTML 失敗

200

414

HTML 為空

200

429

請求次數過多

錯誤回應範例


最后更新于