Skip to main content
GET
Get an app's daily metric history (rating, ratings count, installs, star histogram, price).

Authorizations

x-api-key
string
header
required

Create a key at https://dash.appgoat.ai.

Path Parameters

app
string
required

Any app identifier: App Store id (284882215, id284882215), Play package (com.spotify.music), Apple bundle id (com.spotify.client), store URL (URL-encoded), apple:<id> / play:<id>, or a name (spotify).

Example:

"com.spotify.music"

Query Parameters

store
enum<string>

Disambiguates {app} (a bundle id vs a Play package, or a name).

Available options:
apple,
play
country
string
default:us

ISO country code(s): us (default), a comma list (paid plans), or all (Studio).

Example:

"us,de"

from
string<date>

Start date (ISO), default 90 days before to.

to
string<date>

End date (ISO), default today.

max_age
integer
default:604800

Refresh from the store when our data is older than this many seconds (0 = always). Default 604800 (7 days).

Required range: x >= 0
wait
boolean
default:true

Block up to ~25 s for a refresh (default). false = answer immediately from cache with a job id.

Response

Metric rows, by country then date.

data
object[]
required
meta
object
required