API reference · Apps

An app’s competitors

Who an app is really competing with, in three rings: direct (same job, same user), adjacent (a different app the same people use) and aspirational (bigger apps nearby worth studying). Each with its rating, modelled downloads and revenue a month where we hold them, and why it is in that ring. Takes up to a minute the first time; held a day after.

GET/api/v1/apps/{store}/{appId}/competitors

Costs: Free
MCP tool: get_app_competitors
Answers: At once (200)

curl "https://appleak.app/api/v1/apps/apple/1234567890/competitors" \
  -H "Authorization: Bearer $APPLEAK_KEY"

Response200 OK

{
  "app": {
    "store": "apple",
    "appId": "1234567890",
    "title": "Example Meditation"
  },
  "competitors": [
    {
      "store": "apple",
      "appId": "1111111111",
      "title": "Example Sleep",
      "tier": "direct",
      "reason": "Found searching the store for “sleep sounds” · also about sleep, meditation",
      "rating": 4.8,
      "ratingsTotal": 51200,
      "downloadsMonthly": 42000,
      "downloadsBasis": "ratings",
      "revenueMonthly": null
    }
  ],
  "readAt": "2026-10-28T09:00:00.000Z"
}

#Parameters

Path parameters

store"apple" | "play"required
apple (App Store) or play (Google Play).
appIdstringrequired
The store id: digits for the App Store (e.g. 1234567890), the bundle id for Google Play (e.g. com.example.app). 1–200 characters

Query parameters

countrystringoptionaldefault "us"
Two-letter storefront code, e.g. us, gb, de.

#Returns

The answer as JSON, beside. Free, and does not count against your credits.

MCP: get_app_competitors · List an app’s competitors in three rings (direct, adjacent, aspirational) with rating, ratings count, modelled monthly downloads and revenue where held, and the store facts behind each. Use search_apps first to find the app. Free.