rank

not read-only

Keyword rank

App's position in App Store search results for a keyword (top 200), per storefront. Apps rank not only for literal metadata phrases: queries match the combined word pool of title + subtitle + hidden keyword field (see the coverage tool). With save=true, appends a snapshot to a JSONL history file and reports the change since the previous snapshot for the same keyword/app/storefront. Relative historyFile paths resolve against $OPENASO_HOME or the server's working directory.

input

keyword *

string

App Store search term

appId *

integer

App Store trackId of the app

countries

string[]

2-letter storefront codes, e.g. ["US", "GB", "JP"]. Each storefront is queried separately.(default ["US"])

save

boolean

Append a rank snapshot to history and report the change(default false)

historyFile

string

History JSONL path (default .openaso-history.jsonl); requires save=true

example call

tools/call → rank

{
  "name": "rank",
  "arguments": {
    "keyword": "habit tracker",
    "appId": 6446901002
  }
}

output

keyword *

string

appId *

integer

historyFile

string

resolved absolute path; only with save

storefronts *

object[]

country *

string

appName *

string | null

rank *

integer | null

1-based position, null = not in top 200

totalResults *

integer

integer | null

previous saved rank (null = was not ranked); only with save

change

string

human-readable movement; only with save

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