ASO Atlas

The keyword-field history of one of the user's own App Store apps, read from App Store Connect: which keyword field every past version shipped with, what each version added and removed, and every term ever tried. Use it to answer "have I already tested this keyword, and how did it go?" before suggesting keyword-field changes. One localization per call (`locale`, e.g. "en-US"; defaults to the app's main one; `locales` lists the rest). `versions` are newest first: `added` / `removed` are against the version before, `readded` are added terms that had been used and dropped earlier, `pending` true is a version not on the App Store yet. `affected` pairs a change with the tracked keywords containing the changed words, with their rank up to 14 days before and after the release (`before_checked` / `after_checked` false = not being checked then, a null position with checked true = checked and not ranked; `settled` false = the release is younger than 14 days) - a hint, never proof: rank also moves for other reasons. `terms` is every term ever in the field: `live` false = removed, `stints` over 1 = removed and brought back, `retest` ("retest" or "skip") and `note` are the user's own verdict, set with set_keyword_note. `date_exact` false means the date is when the version was created in App Store Connect, some days before its release. `status` "off" means no key may read the listing yet - tell the user to turn keyword history on at `settings_url` (it needs an App Store Connect key with the Marketing role, or the desktop app); "pending" means the first read is running. Not available for Google Play apps or apps the user does not own. Takes app_id from list_tracked_apps.

get_keyword_history

Get one keyword list with its keywords. Each keyword has its market and, when available, popularity and difficulty. A null popularity with popularity_source 'below_floor' is a measurement - demand exists but sits under the measurable threshold, report it as "<10", not as missing data. A keyword with `pending` true has no metric computed yet (research is queued) - that's "not measured yet", not zero; call again in a moment. A list is multi-market and multi-store: each row is a (keyword, storefront, store) triple. Google Play rows (platform "android") carry an estimated `demand` band and a null popularity - present the band, never a number. Takes list_id from list_keyword_lists.

get_keyword_list

Get the daily history of one App Store performance metric for a tracked app, from the user's connected App Store Connect account - optionally split by a dimension (source_type, territory, device, app_version, or app_referrer/web_referrer for the specific app or website that referred the traffic; only some metric/dimension combinations exist, an invalid one returns the valid dimensions). Use after get_app_performance to pinpoint when something changed (e.g. 'when did US impressions drop?'). Without a dimension, a null value means Apple reported no data that day (a gap, not zero). With a dimension, days without data are omitted and values beyond the top 8 are summed into 'other'. Only works for apps in the user's own App Store Connect account. A Google Play app in the user's linked Play Console has its own metrics instead: installs (new users), uninstalls, active_devices, visitors (store listing visitors), acquisitions (unique users who installed from the listing), conversion_rate, crashes, anrs, rating; installs split by territory, visitors and acquisitions by territory, source_type or search_term (the Google Play search terms that led to the listing). Google posts each day a few days late, so a Play window is the last N days ending on the last reported day; a day with no store listing data reads as 0 visitors whether Google has not posted it yet or nobody visited. Google's own bucket of small values is the column 'other (Google)'. Takes app_id from list_tracked_apps.

get_performance_series

Get related keyword suggestions (store autocomplete) for a seed term in a storefront, on the App Store or Google Play - useful for discovering keyword ideas to research or track.

keyword_suggestions

List the current user's saved keyword lists (research collections). Each entry has the list id (pass it to get_keyword_list as list_id), its name, default market, and keyword count.

list_keyword_lists

List the apps the current ASO Atlas user tracks, on the App Store and Google Play. Each entry has the tracked-app id (pass it to other tools as app_id), the app name, its store (platform: ios or android), its store id (store_id: the App Store id, or the Google Play package name; itunes_id is set for App Store apps only), the storefront it's tracked in, and how many keywords are tracked for it. Paged: returns up to `limit` apps (default 100) plus `total`; pass `next_offset` back as `offset` for the next page, or narrow with `query` (part of the app name).

list_tracked_apps

Re-check an app's keyword rankings, ratings and reviews now (queues background jobs). Rankings already refresh automatically every night, and keywords checked within the last hour are skipped, so only call this after changing an app or its keywords, not to poll. Takes app_id from list_tracked_apps.

refresh_app

⚠️ Remove a competitor from a tracked app. Takes competitor_id (the "id" on a competitor from get_app).

remove_competitor

⚠️ Stop tracking a single keyword and delete its ranking history. Takes keyword_id, which is the tracked-keyword id from get_app (the "id" on a keyword row).

remove_keyword

⚠️ Remove a keyword from a keyword list. By default removes it from every market and store on the list; pass a country and/or platform to remove only those rows. Identify the keyword by its term. Takes list_id from list_keyword_lists.

remove_keyword_from_list

Research keywords in a storefront on the App Store (default) or Google Play (platform "android"). App Store: for each term, its popularity (search volume, 0-100), difficulty (0-100) and result count; a null popularity with popularity_source 'below_floor' is a measurement - demand exists but sits under the measurable threshold, report it as "<10", not as missing data. Google Play: popularity is always null and `demand` carries an estimated band (Very low to Very high) - present the band, never a number. Terms not measured yet are returned under `pending` while their metrics are computed - call again in a moment to get them. Nothing in the user's account changes (no tracked keywords, lists or search history); its only side effects are background jobs: terms not measured yet are queued for measurement, and estimated popularity values are queued for a more precise lookup. To keep terms, save them with create_keyword_list or add_keyword_to_list. Accepts up to 50 terms per call.

research_keywords

Save a draft of an app's store metadata for one storefront in ASO Atlas. App Store apps: title, subtitle, keywords (the keyword field). Google Play apps: title, subtitle (Play's short description) and description (the full description). This does NOT publish to either store - it only updates the draft used by get_app_optimizer. Only the fields you provide are updated, and they overwrite the previously saved draft values (no history is kept); pass an explicit empty string to clear one; fields the app's store does not have are ignored. Takes app_id from list_tracked_apps; country defaults to the app's primary storefront.

save_metadata_draft

Record the user's verdict on a term of their keyword history: whether it is worth testing again (`retest`: "retest" or "skip") and a short note on what happened when it ran. The note shows in the keyword history and next to the keyword field in the metadata optimizer when the term is typed back in. It replaces the previous verdict and note for that term; omit both `retest` and `note` to clear them. The term must be one from get_keyword_history for that `locale`. Takes app_id from list_tracked_apps.

set_keyword_note

Start tracking an app for the current user in a storefront: an App Store app by its App Store id (itunes_id), or a Google Play app by its package name (store_id, e.g. "com.spotify.music") with platform "android". It fetches the app's public listing from the store and, when the user's App Store Connect account is connected, links the app's analytics in a background job. Idempotent: re-tracking an app you already track is a no-op. Returns the new tracked-app id.

track_app

⚠️ Stop tracking an app and permanently delete it, its tracked keywords, ranking history and competitors from the account. Cannot be undone. Takes app_id from list_tracked_apps.

untrack_app