google-play

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Google Play API

Google Play API

Google Play Store app search, details, reviews, permissions, data safety, and developer catalogs — one plain HTTP GET per call, paid as you go. No Play Console access, no developer account, no scraping the storefront HTML.
Base URL:
https://googleplay.fetcher.sh
Google Play Store应用搜索、详情、评论、权限、数据安全及开发者应用目录服务——每次调用仅需一个简单的HTTP GET请求,按使用付费。无需Play Console权限、无需开发者账号、无需爬取商店前端HTML。
基础URL:
https://googleplay.fetcher.sh

Authentication

认证方式

Two ways to pay, same data — full mechanics in the
fetcher
skill
:
bash
undefined
两种付费方式,获取相同数据——完整机制见
fetcher
技能
bash
undefined

1. Prepaid credits (recommended — get a key at https://fetcher.sh/topup

1. 预付费额度(推荐——在https://fetcher.sh/topup获取密钥

or via POST /api/credits/topup, see the fetcher skill)

或通过POST /api/credits/topup,详见fetcher技能)

export FETCHER_API_KEY="bby_live_xxxxxxxxxxxx" curl -H "Authorization: Bearer $FETCHER_API_KEY"
"https://googleplay.fetcher.sh/api/apps?search=meditation"
export FETCHER_API_KEY="bby_live_xxxxxxxxxxxx" curl -H "Authorization: Bearer $FETCHER_API_KEY"
"https://googleplay.fetcher.sh/api/apps?search=meditation"

2. x402 pay-per-call — omit the header; a GET with no payment returns 402

2. x402按调用付费——省略请求头;无付费信息的GET请求会返回402状态码

with machine-readable payment requirements (USDC on Base, Polygon,

附带机器可读的支付要求(基于Base、Polygon、Arbitrum、Monad或Solana网络的USDC)。@x402/fetch会自动签名并重试请求。

Arbitrum, Monad, or Solana). @x402/fetch signs and retries automatically.


Every response is `{ "status": number, "message": string, "data": ... }`; the
HTTP status mirrors `status`.

所有响应格式均为`{ "status": number, "message": string, "data": ... }`;HTTP状态码与`status`字段值一致。

Endpoints (7 — all GET, $0.003/call)

接口(7个——均为GET请求,每次调用$0.003)

EndpointWhat it returns
/api/apps
Apps matching a keyword; price and country filters
/api/apps/{appId}
An app's full details
/api/apps/{appId}/reviews
An app's reviews
/api/apps/{appId}/similar
Apps similar to a given app
/api/apps/{appId}/permissions
An app's requested permissions
/api/apps/{appId}/datasafety
An app's data safety disclosure
/api/developers/{developerId}
A developer's full app catalog
Required on search:
search
. Optional:
price
(
all
,
free
,
paid
),
country
,
lang
. Reviews require
country
; optional
sort
(
NEWEST
,
RATING
,
HELPFULNESS
).
接口返回内容
/api/apps
匹配关键词的应用;支持价格和地区筛选
/api/apps/{appId}
应用的完整详情
/api/apps/{appId}/reviews
应用的评论
/api/apps/{appId}/similar
与指定应用相似的应用
/api/apps/{appId}/permissions
应用请求的权限
/api/apps/{appId}/datasafety
应用的数据安全披露
/api/developers/{developerId}
开发者的完整应用目录
搜索接口必填参数:
search
。可选参数:
price
all
free
paid
)、
country
lang
。评论接口必填
country
;可选参数
sort
NEWEST
RATING
HELPFULNESS
)。

Scenarios

使用场景

Free apps only:
bash
curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "search=meditation" -G \
  --data-urlencode "price=free" \
  "https://googleplay.fetcher.sh/api/apps"
Paid apps, German storefront:
bash
curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "search=photo editor" -G \
  --data-urlencode "price=paid" \
  --data-urlencode "country=de" \
  "https://googleplay.fetcher.sh/api/apps"
An app's full details, then reviews sorted by rating:
bash
curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://googleplay.fetcher.sh/api/apps/com.spotify.music"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "country=us" -G \
  --data-urlencode "sort=RATING" \
  "https://googleplay.fetcher.sh/api/apps/com.spotify.music/reviews"
Permissions and data safety disclosure:
bash
curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://googleplay.fetcher.sh/api/apps/com.spotify.music/permissions"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://googleplay.fetcher.sh/api/apps/com.spotify.music/datasafety"
Apps similar to a given app, and a developer's full catalog:
bash
curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://googleplay.fetcher.sh/api/apps/com.spotify.music/similar"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "country=us" -G \
  "https://googleplay.fetcher.sh/api/developers/Spotify+AB"
仅搜索免费应用:
bash
curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "search=meditation" -G \
  --data-urlencode "price=free" \
  "https://googleplay.fetcher.sh/api/apps"
搜索德国商店的付费应用:
bash
curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "search=photo editor" -G \
  --data-urlencode "price=paid" \
  --data-urlencode "country=de" \
  "https://googleplay.fetcher.sh/api/apps"
获取应用完整详情,再按评分排序获取评论:
bash
curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://googleplay.fetcher.sh/api/apps/com.spotify.music"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "country=us" -G \
  --data-urlencode "sort=RATING" \
  "https://googleplay.fetcher.sh/api/apps/com.spotify.music/reviews"
获取权限和数据安全披露:
bash
curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://googleplay.fetcher.sh/api/apps/com.spotify.music/permissions"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://googleplay.fetcher.sh/api/apps/com.spotify.music/datasafety"
获取与指定应用相似的应用,以及开发者的完整应用目录:
bash
curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://googleplay.fetcher.sh/api/apps/com.spotify.music/similar"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "country=us" -G \
  "https://googleplay.fetcher.sh/api/developers/Spotify+AB"

MCP

MCP

json
{
  "mcpServers": {
    "google-play": {
      "url": "https://googleplay.fetcher.sh/mcp",
      "headers": { "Authorization": "Bearer bby_live_..." }
    }
  }
}
Free:
search_endpoints
,
describe_endpoint
,
check_balance
. Paid:
fetch_data
(any endpoint above),
topup_credits
, plus the named shortcut
googleplay_apps
. Drop the
headers
block to pay per call with x402 instead — see the
fetcher
skill
for the full flow.
json
{
  "mcpServers": {
    "google-play": {
      "url": "https://googleplay.fetcher.sh/mcp",
      "headers": { "Authorization": "Bearer bby_live_..." }
    }
  }
}
免费接口:
search_endpoints
describe_endpoint
check_balance
。付费接口:
fetch_data
(上述任意接口)、
topup_credits
,以及命名快捷方式
googleplay_apps
。若要通过x402按调用付费,可移除
headers
块——完整流程见
fetcher
技能

Errors

错误码

  • 400
    — missing/invalid parameter (message names it)
  • 401
    — unknown or rotated key
  • 402
    — payment required (x402 challenge) or
    topup_required
    (credits exhausted)
  • 404
    — not a priced path
  • No rate limits; no refunds on upstream failures (settlement precedes delivery)
  • 400
    —— 参数缺失/无效(消息中会指明具体参数)
  • 401
    —— 密钥未知或已过期
  • 402
    —— 需要付费(x402验证挑战)或
    topup_required
    (额度耗尽)
  • 404
    —— 不存在该付费路径
  • 无速率限制;上游服务失败不退款(结算先于数据交付)

Reference

参考链接