tools / search_terms
search_terms
read-onlyApple's top search terms (weekly popularity)
Apple's own weekly App Store search-term popularity for a storefront, from the official Apple Ads API: the top terms by Apple's 1-100 popularity, optionally within one genre, with movement against an earlier week. view=top ranks by popularity; rising/falling sort by the popularity change against the comparison week (default: last week); new lists terms Apple started listing this week. Apple publishes only its top ~500 terms per genre (a term missing from a week was simply outside those lists), for ~90 of 175 storefronts; openaso archives the pulse storefronts (US, GB, JP, DE, FR, KR, CA, AU, BR, IN) weekly. Use it to spot demand shifts and seasonal terms before choosing metadata, then price individual phrases with volume. No network: reads the archive.
input
country
string
Storefront (one of the archived pulse storefronts)(default "US")
genre
string
Apple genre key to scope to — one of BUSINESS, EDUCATION, ENTERTAINMENT, FINANCE, FOOD_DRINK, GAMES, HEALTH_FITNESS, LIFESTYLE, NEW_PUBLICATION, PHOTO_VIDEO, PRODUCTIVITY_UTILITIES, SHOPPING, SOCIAL_NETWORKING, SPORTS, TRAVEL (omit for all genres, one row per term)
view
"top" | "rising" | "falling" | "new"
top = by popularity; rising/falling = by popularity change vs the comparison week; new = not listed in the comparison week(default "top")
limit
integer
(default 50)
compareWeeks
integer
How many weeks back the comparison week is (1 = week over week)(default 1)
example call
tools/call → search_terms
{ "name": "search_terms", "arguments": {} }
output
country *
string
genre *
string | null
the genre filter, null for the cross-genre view
view *
"top" | "rising" | "falling" | "new"
week *
string | null
Apple's week key (YYYY-MM-DD, the Sunday after the completed Sun-Sat week); null when nothing is archived for the storefront
comparedTo *
string | null
week the movement is measured against; null when that week is not archived
terms *
object[]
term *
string
genre *
string
rankInGenre *
integer
popularity *
integer
Apple's 1-100 popularity across genres
popularityInGenre *
integer
Apple's 1-100 popularity within the genre
previousPopularity *
integer | null
popularity in the comparison week; null when not listed then
change *
integer | null
popularity - previousPopularity
previousRank *
integer | null
rankInGenre in the comparison week
rankChange *
integer | null
previousRank - rankInGenre (positive = climbed)
note *
string