tools / app_keywords
app_keywords
read-onlyKeywords an app ranks for
Reverse keyword lookup for ANY app, competitors included: the keywords it ranks for in the top 50 App Store results, with its position, Apple's real Search Ads popularity where Apple lists the term, and how its position moved against the snapshot `changeDays` back. Reads openaso's archive of every keyword it has snapshotted (the autocomplete corpus plus looked-up and tracked terms, US-heavy) — not an exhaustive crawl, so confirm a single phrase with rank. sort=popularity (default) puts the demand that Apple publishes first; sort=position shows where the app is strongest. Use competitors to see who else is on a keyword, keyword_gap for what rivals have that you don't. No network: reads the archive.
input
appId *
integer
App Store trackId of the app
country
string
Storefront. The keyword archive is US-heavy; charts cover the ten pulse storefronts (US, GB, JP, DE, FR, KR, CA, AU, BR, IN)(default "US")
limit
integer
(default 50)
sort
"popularity" | "position"
(default "popularity")
maxPosition
integer
Only keywords where the app ranks at or above this position
minPopularity
integer
Only keywords Apple lists at or above this popularity
contains
string
Only keywords containing this text
changeDays
integer
Compare positions against the snapshot this many days back(default 7)
example call
tools/call → app_keywords
{ "name": "app_keywords", "arguments": { "appId": 6446901002 } }
output
appId *
integer
country *
string
app *
object | null
name
string
developer
string
rating
number | null
ratings
integer
indexed *
object
How many keywords the app is indexed on (full counts, not just the rows returned)
total
integer
top3
integer
top10
integer
top50
integer
updatedAt
string | null
popularityWeek *
string | null
changeDays *
integer
keywords *
object[]
keyword *
string
position *
integer
popularity *
integer | null
Apple's 1-100 popularity; null for terms Apple does not list this week
previousPosition *
integer | null
position in the comparison snapshot; null = outside the top 200 then
change *
integer | null
previousPosition - position (positive = climbed)
status *
"new" | "up" | "down" | "steady" | "unknown"
new = outside the top 200 in the comparison snapshot; unknown = no snapshot old enough to compare
comparedAt *
string | null
timestamp of the snapshot the comparison used (the newest at or before changeDays back, looking back up to three times as far); null when none
note *
string