Skip to main content
GET
List an app's user reviews, newest first, with filters (rating, version, date, text).

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"

rating
string

Star rating filter, 1, 1,2 or a range 1-3.

Example:

"1-2"

version
string

Only reviews written for this app version.

since
string<date-time>

Only items at or after this ISO date / datetime.

Example:

"2026-10-01"

until
string<date-time>

Only reviews created before this ISO date / datetime.

q
string

Case-insensitive text search in the title and body.

Example:

"crash"

sentiment
string

AI sentiment filter (comma list): positive, neutral, negative.

Example:

"negative"

intent
string

AI intent filter (comma list): bug, crash, feature_request, pricing, ux, praise, spam, other.

Example:

"bug,crash"

topic
string

AI topic filter (comma list of topic labels, case-insensitive, or topic ids).

max_age
integer
default:86400

Refresh the latest US reviews when older than this many seconds. Default 86400 (1 day).

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.

limit
integer
default:50
Required range: 1 <= x <= 100
cursor
string

meta.next_cursor from the previous page.

fields
string

Comma list of top-level fields to return (identifiers are always kept), e.g. title,rating,version.

Response

A page of reviews.

data
object[]
required
meta
object
required