Find an app's competitors (store "similar apps" plus apps ranking for the same keywords).

GEThttps://api.appgoat.ai/v1/apps/{app}/competitors

1 creditMCP tool get_competitorsoperationId listCompetitors

Scored list: shared_keywords (search terms both apps rank for) counts most, the store's own similar-apps list (similar_position) adds a boost. Feed the result into getApp / listAppChanges for a competitor digest.

Request

curl "https://api.appgoat.ai/v1/apps/com.spotify.music/competitors?limit=5" \
  -H "x-api-key: $APPGOAT_API_KEY"

const res = await fetch("https://api.appgoat.ai/v1/apps/com.spotify.music/competitors?limit=5", {
  headers: {
    "x-api-key": process.env.APPGOAT_API_KEY,
  },
});
const { data, meta } = await res.json();

import os, requests

res = requests.get(
    "https://api.appgoat.ai/v1/apps/com.spotify.music/competitors?limit=5",
    headers={"x-api-key": os.environ["APPGOAT_API_KEY"]}
)
body = res.json()

Path parameters

appstringrequired

Any app identifier: App Store id (284882215, id284882215), Play package (com.spotify.music), Apple bundle id (com.spotify.client), store URL (URL-encoded), apple:<id> / play:<id>, or a name (spotify).

Query parameters

store"apple" | "play"

Disambiguates {app} (a bundle id vs a Play package, or a name).

countrystring

ISO country code(s): us (default), a comma list (paid plans), or all (Studio).

Default "us"

limitinteger

Default 20

Response

200 with data: Competitor[]. See the envelope for meta.

storeStore

app_idstring

titlestring | null

developer_namestring | null

icon_urlstring | null

categorystring | null

ratingnumber | null

ratings_countinteger | null

installs_mininteger | null

Play install bucket lower bound.

pricenumber | null

shared_keywordsinteger

best_shared_rankinteger | null

similar_positioninteger | null

Position in the store's similar-apps list.

scorenumber

Example

{
  "data": [
    {
      "store": "apple",
      "app_id": "324684580",
      "title": "Spotify: Music and Podcasts",
      "developer_name": "string",
      "icon_url": "string",
      "category": "string",
      "rating": 4.5,
      "ratings_count": 1,
      "installs_min": 1,
      "price": 4.5,
      "shared_keywords": 1,
      "best_shared_rank": 1,
      "similar_position": 1,
      "score": 4.5
    }
  ],
  "meta": {
    "credits_used": 1,
    "credits_remaining": 9981,
    "request_id": "req_123"
  }
}

Status codes

200

Competitors, best first.

401invalid_api_key

Missing or invalid API key.

402insufficient_creditsplan_limit

insufficient_credits (the call costs more than you have left; nothing was done) or plan_limit (a feature of a higher plan).

404app_not_found

Nothing matches {app}, or the store does not have it.

429rate_limited

Too many requests per second for your plan.