Check App Store keyword ranking metrics by app ID

Provide one or two App Store app IDs: the numeric identifier after id in an App Store page URL, rather than an app name or bundle identifier. This endpoint currently supports United States location_code 2840 and the full language_name English only. It does not search for an app ID from a name.

The bands count covered organic search-result pages where the app appears first, second–third, fourth–tenth or eleventh–hundredth. The accompanying count is the total number of covered organic search-result pages containing that app. These are grouped search records, not one overall rank, an average position or an App Store chart rank. Keep the returned figures as reported rather than forcing the band totals to match another count.

It combines the supplier’s search-volume figures for the app’s covered ranking keywords. The exact measurement period and estimation method are not specified for this endpoint. It is not a count of unique people, actual app impressions, traffic or downloads, and the aggregate does not provide an individual keyword list.

Your Agent can compare available summaries for the one or two supplied IDs. Match each record by its returned app_id, since response order need not follow input order. A returned app-record count or supplier database total is separate from the number of covered search results for an app. Missing records or metrics remain unknown; do not replace them with zero or infer that the app never ranks.

This call retrieves metrics from the supplier’s database in a single request. The supplier describes weekly database updates; that does not establish the exact update date or age of these metrics. It does not recapture live rankings or maintain a continuous history, and the native request has no date-range or tracking controls.