tools / history

history

read-only

Rank history report

Read this account's server-side rank history (written by track and the daily managed run): one series per (keyword, app, storefront) with snapshot count, current/previous/best/worst rank and time range. dropsOnly=true returns only series whose latest snapshot is worse than the previous one (rank-drop check). Filterable; no network. Series stats cover each series' most recent 365 snapshots.

input

keyword

string

Only series for this exact keyword

appId

integer

Only series for this app

country

string

Only series for this storefront

since

string

Only records at/after this ISO date/timestamp (date-only values are interpreted as UTC midnight)

records

integer

Include the last N raw records per series

dropsOnly

boolean

Only series that dropped (rank got worse, or fell out of the top 200)(default false)

example call

tools/call → history

{
  "name": "history",
  "arguments": {}
}

output

series *

object[]

keyword *

string

appId *

integer

country *

string

snapshots *

integer

current *

integer | null

rank in the latest snapshot

integer | null

rank in the snapshot before the latest; absent with one snapshot

best *

integer | null

best (lowest) rank ever; null if never ranked

worst *

integer | null

firstRank *

integer | null

firstTs *

string

lastTs *

string

records

object[]

most recent raw records, oldest first; only when records > 0 was requested

ts *

string

keyword *

string

appId *

integer

country *

string

rank *

integer | null

endpoint https://openaso-806591819206.us-west1.run.app/mcp · auth Authorization: Bearer <key> · get a key