tools / app_traction
app_traction
read-onlyHow fast an app is growing
Public traction signals for any app, competitors included: ratings gained over the last 7, 30 and 90 days and the per-day rate (App Store ratings accrue with usage, so this is a relative velocity, comparable across similar apps — not a download count), whether it is accelerating, how many keywords it is visible on (top 3 / 10 / 50), and its current chart positions. Built from the same archives as app_keywords and app_ranks; the ratings series needs the app to appear in archived keyword results, so tiny apps may have none. Apple publishes no downloads or revenue for other developers' apps — pair with revenue for a grossing-rank band. No network.
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")
days
integer
How far back to read the ratings series(default 90)
example call
tools/call → app_traction
{ "name": "app_traction", "arguments": { "appId": 6446901002 } }
output
appId *
integer
country *
string
ratings *
object
current *
integer | null
latest archived ratings count
rating *
number | null
latest archived average rating
asOf *
string | null
UTC day of the newest archived point current/rating come from — the archive refreshes unevenly, so check it
windows *
object[]
days *
integer
gained *
integer | null
ratings gained over the window; null when the archive has no point inside the window or none old enough to measure from
perDay *
number | null
firstSeen *
string | null
points *
object[]
date *
string
ratings *
integer
acceleration *
number | null
ratings per day over the last 7 days divided by the 7 before; > 1 = accelerating
keywords *
object
total *
integer
top3 *
integer
top10 *
integer
charts *
object[]
chart *
"top-free" | "top-paid" | "top-grossing"
genre *
string
genreId *
integer | null
current *
integer | null
best *
integer | null
daysOnChart *
integer
note *
string