Google Play 入站关键词 API
按月份分页查询导向 play.google.com 的 Google 自然搜索关键词，查看点击量、搜索量、CPC、难度、搜索意图和 Google Play 目标页面。
按月份分页查询导向 play.google.com 的 Google 自然搜索关键词，查看点击量、搜索量、CPC、难度、搜索意图和 Google Play 目标页面。
打开产品页与 API Tester查询流程
先调用免费批次接口，从 data.result["play.google.com"] 读取月份，再使用 month 和 page 查询关键词。固定查询 play.google.com，不接受 host 或自定义域名。两个接口均需 API Key，沿用账户限流。
可用月份与状态
GET https://api.goanyapi.com/api/v1/google-play-inbound-keyword/batches| 参数 | 规则 |
|---|---|
| — | 不接受参数。 |
此接口免费，不扣除积分。
curl "https://goanyapi.com/api/v1/google-play-inbound-keyword/batches" \
-H "Authorization: Bearer $GOANYAPI_API_KEY"SUCCESS 表示更新完毕，RUNNING 表示更新中。month 是数据月份。
批次的 page 字段表示该月份可用关键词的总页数。RUNNING 批次仍在更新，总页数可能继续变化。
分页关键词
GET https://api.goanyapi.com/api/v1/google-play-inbound-keyword/list| 参数 | 规则 |
|---|---|
month | 必填。YYYY-MM，使用批次查询返回的月份。 |
page | 可选。从 1 开始的整数，最大 2147483647，默认 1；每页单独请求。 |
当前配置下，每次成功请求消耗 1 积分。
curl "https://goanyapi.com/api/v1/google-play-inbound-keyword/list?month=2026-09&page=1" \
-H "Authorization: Bearer $GOANYAPI_API_KEY"每次获取一页；page 默认 1。非空成功页按当前数据库配置扣费；空数组和失败不扣费，重复获取同一页照常计费。Tester 将可用月份作为关键词列表的筛选条件，通过免费批次查询加载选项；修改月份或页码不会自动请求关键词列表。不要把当前页记录数或批次 page 推算为全部关键词数量。
响应结构与字段
成功响应为 code: "ok"，data 包含 endpoint、query、result、creditsUsed 和 remainingCredits。批次 result 是以 play.google.com 为键的对象；关键词 result 是数组。
| JSON |
|---|
data.result[].keyword |
data.result[].clicks |
data.result[].organic_clicks |
data.result[].desktop_clicks |
data.result[].previous_clicks_pop |
data.result[].share |
data.result[].previous_share_pop |
data.result[].clicks_change |
data.result[].change_ratio |
data.result[].change_state |
data.result[].keyword_volume |
data.result[].keyword_volume_average |
data.result[].zero_clicks_share |
data.result[].cpc |
data.result[].cpc_low_bid |
data.result[].cpc_high_bid |
data.result[].difficulty |
data.result[].competition |
data.result[].primary_intent |
data.result[].top_url |
data.result[].url_count |
data.result[].latest_keyword_serp_date |
data.result[].keyword_window_volume |
data.result[].previous_volume |
data.result[].volume_change_state |
data.result[].serp_features |
所有公开业务字段保留实际数值、null、空字符串、空数组和缺失状态；不补造默认值、不因字段缺失丢弃记录。top_url 保留返回的原始地址。clicks、搜索量、CPC 和难度按返回值解释，不代表 Google Play 站内搜索、应用安装量或 Google Play 官方归因。
错误与计费
参数非法返回 400，未鉴权返回 401，余额不足返回 402，限流返回 429，请求失败返回 502，价格未配置返回 503。HTTP 失败、无效 JSON、明确业务失败走错误流程，不扣查询积分；字段为空本身不是失败。HEAD 返回 405，不触发查询。