App Store

App-store intelligence across the Apple App Store and Google Play: keyword app search, app detail lookups, and recent customer reviews. Built for ASO research, competitive app tracking, and review monitoring.

What it scrapes

Source	Data
Apple App Store	App metadata by numeric App Store id; most recent customer reviews for an app
Google Play	App metadata by Android package id (e.g. com.coinbase.app)
Both stores	Keyword app search (store=auto returns hits from both)

Endpoints

Router: routers/app_store_data.py · tag: App Store Data

Method	Path	Summary
GET	/v1/appstore/search	Search apps by keyword across Apple + Google Play (store = auto | apple | play)
GET	/v1/appstore/apple/{app_id}	Apple App Store app details by numeric id
GET	/v1/appstore/apple/{app_id}/reviews	Most recent Apple App Store customer reviews
GET	/v1/appstore/play/{package}	Google Play app details by Android package id

GET /v1/appstore/search

Query params: query (required, e.g. crypto wallet), store (auto | apple | play, default auto), limit (1–100, default 20).

curl -X GET "http://localhost:8005/v1/appstore/search?query=crypto%20wallet&store=apple&limit=5" \
  -H "Authorization: Bearer <key>"

Response (200):

{
  "success": true,
  "query": "crypto wallet",
  "store": "apple",
  "data": [
    {
      "store": "apple",
      "name": "Coinbase Wallet: NFTs & Crypto",
      "app_id": "1278383455",
      "publisher": "Coinbase, Inc.",
      "price": 0,
      "currency": "USD",
      "rating": 4.5,
      "reviews_count": 11800,
      "url": "https://apps.apple.com/us/app/id1278383455"
    }
  ]
}

GET /v1/appstore/apple/{app_id}

Path params: app_id (numeric Apple App Store id).

curl -X GET "http://localhost:8005/v1/appstore/apple/1278383455" \
  -H "Authorization: Bearer <key>"

Response (200):

{
  "success": true,
  "app_id": "1278383455",
  "data": {
    "name": "Coinbase Wallet: NFTs & Crypto",
    "publisher": "Coinbase, Inc.",
    "price": 0,
    "currency": "USD",
    "rating": 4.5,
    "reviews_count": 11800,
    "version": "14.25.0",
    "updated_at": "2026-08-01",
    "url": "https://apps.apple.com/us/app/id1278383455"
  }
}

GET /v1/appstore/apple/{app_id}/reviews

Path params: app_id (numeric Apple App Store id). Query params: limit (1–100, default 20).

curl -X GET "http://localhost:8005/v1/appstore/apple/1278383455/reviews?limit=5" \
  -H "Authorization: Bearer <key>"

Response (200):

{
  "success": true,
  "app_id": "1278383455",
  "data": [
    {
      "rating": 5,
      "title": "Best wallet",
      "body": "Simple, secure, and the browser integration is great.",
      "author": "crypto.enthusiast",
      "date": "2026-08-10"
    }
  ]
}

GET /v1/appstore/play/{package}

Path params: package (Android package id, e.g. com.coinbase.app).

curl -X GET "http://localhost:8005/v1/appstore/play/com.coinbase.app" \
  -H "Authorization: Bearer <key>"

Response (200):

{
  "success": true,
  "package": "com.coinbase.app",
  "data": {
    "name": "Coinbase: Buy Bitcoin & Ether",
    "publisher": "Coinbase, Inc.",
    "price": 0,
    "currency": "USD",
    "rating": 4.4,
    "reviews_count": 2910000,
    "installs": "100,000,000+",
    "version": "v25.8.1",
    "updated_at": "2026-08-05",
    "url": "https://play.google.com/store/apps/details?id=com.coinbase.app"
  }
}

MCP tools

The Pry MCP server exposes the app-store lane as two tools (71 tools total):

Tool	Backing endpoint
pry_app_search	GET /v1/appstore/search
pry_app_reviews	GET /v1/appstore/apple/{app_id}/reviews

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "pry_app_search",
    "arguments": {"query": "crypto wallet", "country": "us", "limit": 5}
  }
}

Both tools are x402 pay-per-call at $0.002/call (see /v1/x402/pricing).

Who uses this

• ASO teams — keyword search to benchmark ranking potential and metadata.
• Competitive research — app details + rating history for rival apps.
• Review monitoring — pry_app_reviews for support-bot and sentiment pipelines feeding off store feedback.
• Marketplace analysts — install counts, pricing, and update cadence by publisher.

Next steps

• News — track press around an app or publisher
• MCP Integration — run the tools from Claude / Cursor / Hermes