List the search keywords an app ranks for, best rank first, with popularity and difficulty.

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

1 creditMCP tool get_app_keywordsoperationId listAppKeywords

From the latest ranking we hold for each term: our keyword universe (re-ranked weekly, top 50) plus your own tracked keywords (source: tracked). Use it for ASO audits and to find keyword gaps against a competitor (call it for both apps and compare).

Request

curl "https://api.appgoat.ai/v1/apps/com.spotify.music/keywords?max_rank=10" \
  -H "x-api-key: $APPGOAT_API_KEY"

const res = await fetch("https://api.appgoat.ai/v1/apps/com.spotify.music/keywords?max_rank=10", {
  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/keywords?max_rank=10",
    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"

max_rankinteger

Only terms where the app ranks at or above this position.

limitinteger

Default 100

cursorstring

meta.next_cursor from the previous page.

Response

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

termstring

countrystring

rankinteger

popularityinteger | null

popularity_source"apple" | "proxy" | null

difficultyinteger | null

results_countinteger | null

ranked_atstring

source"universe" | "tracked"

tracked_keyword_idinteger

Example

{
  "data": [
    {
      "term": "photo editor",
      "country": "us",
      "rank": 1,
      "popularity": 1,
      "popularity_source": "apple",
      "difficulty": 1,
      "results_count": 1,
      "ranked_at": "2026-10-22T10:00:00Z",
      "source": "universe",
      "tracked_keyword_id": 1
    }
  ],
  "meta": {
    "credits_used": 1,
    "credits_remaining": 9981,
    "request_id": "req_123"
  }
}

Status codes

200

Ranked terms.

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.