App Reviews

Fetch user reviews for an app with sorting and pagination.

Endpoint

GET /api/insights/{store}/app/{bundleId}/reviews/

Path Parameters

Parameter	Required	Description
`store`	Yes	`apple` or `google`
`bundleId`	Yes	App bundle identifier

Query Parameters

Parameter	Type	Default	Description
`country`	string	Smart fallback	Country code
`lang`	string	—	Language code
`sort`	string	`mostRecent`	Sort order (see below)
`limit`	number	`20`	Reviews per page (max 200)
`page`	number	`1`	Page number (Apple only, max 10)

Sort Values

Apple: mostRecent, mostHelpful (aliases: newest, helpful, rating)

Google: NEWEST, RATING, HELPFULNESS (aliases: newest, rating, helpful)

Example Request

GET /api/insights/google/app/com.spotify.music/reviews/?country=us&sort=newest&limit=10

Response

Returns an array of normalized reviews:

[
  {
    "id": "abc123",
    "userName": "John D.",
    "score": 5,
    "title": "Great app!",
    "text": "Love the new design and features...",
    "date": "2025-02-18T14:30:00Z",
    "url": "https://..."
  }
]

The title field is only available for Apple reviews. Google reviews do not have separate titles.

Cache

Header	Value
`s-maxage`	86400 (24 hours)
`max-age`	3600 (1 hour)
`stale-while-revalidate`	7200 (2 hours)

Errors

Status	Description
400	Missing/invalid `store` or `bundleId`
404	App not found
500	Upstream API failure