Google Play 搜索

Google Play 搜索 SERP，覆盖应用商店结果及其筛选参数。

本页给出 Google Play 搜索的字段定义、参数分组、必填约束以及可用过滤参数。

元数据

字段	值
引擎名称	Google Play 搜索
原始名称	Google Play Search
内部标识（scraper）	`google_play_search`
接口标识（engine）	`google_play_search`
网站	Google Play
网站地址	googleplay.com
输出格式	`json`
版本	`1.0.0`
参数数量	`5`
参数分组	搜索词 (1), 地区与语言 (2), 高级参数 (1), 请求控制 (1)

请求示例

下面的请求体是本次文档更新时实际用于验证 google_play_search 的请求。对于 /v1/serp，engine 字段应传当前引擎的 scraper 值。

curl -X POST "https://run.xcrawl.com/v1/serp" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"engine":"google_play_search","q":"browser"}'

响应示例

下面的 JSON 片段来自同一次真实响应。为了避免页面被超长字段淹没，超长字符串、data URL 和大型数组做了裁剪。

{
  "search_metadata": {
    "cached": true,
    "created_at": "2026-03-26 08:22:04 UTC",
    "id": "01KMMKRPKQP615TBSERJ5GJM43",
    "json_endpoint": "https://serp.xcrawl.com/01KMMKRPKQP615TBSERJ5GJM43.json",
    "processed_at": "2026-03-26 08:22:04 UTC",
    "raw_html_file": "https://serp.xcrawl.com/01KMMKRPKQP615TBSERJ5GJM43.html",
    "status": "completed",
    "total_time_taken": 9
  },
  "search_parameters": {
    "engine": "google_play_search",
    "q": "browser"
  },
  "total_credits_used": 1,
  "organic_results": [
    {
      "items": [
        {
          "author": "Brave Software",
          "category": "Communication",
          "description": "<b>Browse 3X faster on Brave Browser.</b> Get a lightning fast, safe and private web browser with AI, Adblock, and VPN. <br><br>Loved by over 100 million users, Brave has AI assistant Brave Leo, Firewall + VPN, Brave Sea... [truncated, 3145 chars]",
          "downloads": "100,000,000+",
          "feature_image": "https://play-lh.googleusercontent.com/45reN4o-43FSN0uIEOdg2L6USFIMXLUiJKgIfGcc5rIDjtqO2KYa9I67z3BQuozQ2YWK",
          "link": "https://play.google.com/store/apps/details?id=com.brave.browser",
          "_note": "4 more fields omitted"
        },
        {
          "_note": "24 more items omitted"
        }
      ]
    }
  ]
}