app-store

Apple App Store API

App Store のアプリやバンドルの検索、詳細、レビュー、類似アプリ、開発者カタログを、どの国のストアフロントからでも取得できます。呼び出しごとに通常の HTTP GET を 1 回送信し、使った分だけ支払います。Apple Developer Program への加入も、App Store Connect へのアクセスも、ストアフロント HTML のスクレイピングも必要ありません。

ベース URL：https://appstore.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://appstore.fetcher.sh/api/apps?term=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 と同じ値になります。

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

エンドポイント	返される内容
/api/apps	キーワードに一致するアプリ。ページと国別ストアフロントで絞り込み可能
/api/apps/{appId}	アプリの全詳細
/api/apps/{appId}/reviews	アプリのレビュー
/api/apps/{appId}/similar	指定したアプリに類似するアプリ
/api/bundles	キーワードに一致するアプリバンドル
/api/bundles/{bundleId}	バンドルの全詳細
/api/bundles/{bundleId}/reviews	バンドルのレビュー
/api/bundles/{bundleId}/similar	指定したバンドルに類似するバンドル
/api/developers/{developerId}	開発者の全アプリカタログ

/api/apps と /api/bundles では、term が必須です。すべてのエンドポイントで、country（ストアフロント。例：us、jp、de）、lang、page は任意です。レビューでは sort（recent、helpful）を指定できます。

使用例

米国のストアフロントで検索：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "term=habit tracker" -G \
  --data-urlencode "country=us" \
  "https://appstore.fetcher.sh/api/apps"

日本のストアフロントで検索：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "term=camera" -G \
  --data-urlencode "country=jp" \
  "https://appstore.fetcher.sh/api/apps"

アプリの全詳細を取得し、続けて有用度順にレビューを取得：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "country=us" -G \
  "https://appstore.fetcher.sh/api/apps/324684580"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "country=us" -G \
  --data-urlencode "sort=helpful" \
  "https://appstore.fetcher.sh/api/apps/324684580/reviews"

指定したアプリに類似するアプリを取得：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "country=us" -G \
  "https://appstore.fetcher.sh/api/apps/324684580/similar"

アプリバンドルを検索して取得：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "term=photo editing suite" -G \
  "https://appstore.fetcher.sh/api/bundles"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "country=us" -G \
  "https://appstore.fetcher.sh/api/bundles/1234567890"

開発者の全アプリカタログを取得：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://appstore.fetcher.sh/api/developers/284882218"

MCP

{
  "mcpServers": {
    "app-store": {
      "url": "https://appstore.fetcher.sh/mcp",
      "headers": { "Authorization": "Bearer bby_live_..." }
    }
  }
}

無料：search_endpoints、describe_endpoint、check_balance。有料：fetch_data（上記の任意のエンドポイント）、topup_credits、および名前付きショートカットの appstore_apps。代わりに x402 で呼び出しごとに支払う場合は、headers ブロックを削除してください。詳しい手順は fetcher スキルをご覧ください。

エラー

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

リファレンス

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