google-play

Google Play API

Google Play ストアのアプリ検索、詳細、レビュー、権限、データ セーフティ、デベロッパーのカタログを取得できます。1 回の呼び出しにつき通常の HTTP GET を 1 回実行し、使った分だけ支払います。Play Console へのアクセスも、デベロッパーアカウントも、ストアフロントの HTML のスクレイピングも不要です。

ベース URL：https://googleplay.fetcher.sh

認証

支払い方法は 2 種類で、取得できるデータは同じです。詳しい仕組みは fetcher スキルをご覧ください。

# 1. Prepaid credits (recommended — get a key at https://fetcher.sh/topup
#    or via POST /api/credits/topup, see the fetcher skill)
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
#    with machine-readable payment requirements (USDC on Base, Polygon,
#    Arbitrum, Monad, or Solana). @x402/fetch signs and retries automatically.

すべてのレスポンスは { "status": number, "message": string, "data": ... } です。HTTP ステータスは status と一致します。

エンドポイント（7 種類、すべて GET、1 回あたり $0.003）

エンドポイント	返される内容
/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）は省略可能です。

使用例

無料アプリのみ：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "search=meditation" -G \
  --data-urlencode "price=free" \
  "https://googleplay.fetcher.sh/api/apps"

有料アプリ、ドイツのストアフロント：

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"

アプリの全詳細を取得し、続けて評価順に並べたレビューを取得：

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"

権限とデータ セーフティに関する開示情報：

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"

指定したアプリに類似するアプリと、デベロッパーのアプリカタログ全体：

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

{
  "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 スキルをご覧ください。

エラー

• 400 — パラメーターがないか無効です（メッセージにその名前が示されます）
• 401 — キーが不明、またはローテーションされています
• 402 — 支払いが必要です（x402 チャレンジ）、または topup_required（クレジットを使い切りました）
• 404 — 価格設定の対象外のパスです
• レート制限はありません。上流で障害が発生した場合も返金はありません（配信前に決済されます）

参考資料

• エージェントのセットアップ全般：https://googleplay.fetcher.sh/skill.md
• OpenAPI 3.1 コントラクト：https://googleplay.fetcher.sh/openapi.json
• 要約カタログ：https://googleplay.fetcher.sh/llms.txt
• 支払い、クレジット、MCP の詳細：fetcher スキル
• サイト：https://googleplay.fetcher.sh