API reference · Reviews

A pull’s reviews

Page through the reviews a pull kept, newest first or by rating or helpful votes, narrowed by rating, a word, storefront, app, version, dates or whether the developer replied. Up to 500 a page; `next` is the offset of the page after, null on the last.

GET/api/v1/reviews/pulls/{id}/reviews

Costs: Free
MCP tool: get_pull_reviews
Answers: At once (200)

curl "https://appleak.app/api/v1/reviews/pulls/0b8e2f4a-7c1d-4e9b-a2f3-5d6c7e8f9a01/reviews?stars=1%2C2&limit=100" \
  -H "Authorization: Bearer $APPLEAK_KEY"

Response200 OK

{
  "pull": {
    "id": "0b8e2f4a-7c1d-4e9b-a2f3-5d6c7e8f9a01",
    "status": "completed"
  },
  "total": 312,
  "offset": 0,
  "limit": 100,
  "next": 100,
  "reviews": [
    {
      "storeReviewId": "11223344556",
      "store": "apple",
      "appId": "1234567890",
      "app": "Example Gym Log",
      "rating": 1,
      "title": "Crashes every workout",
      "text": "Since the update it crashes when I log a set, and support never answers.",
      "date": "2026-10-12T08:30:00.000Z",
      "country": "us",
      "version": "5.4.1",
      "helpful": 3,
      "reply": null,
      "repliedAt": null
    }
  ]
}

#Parameters

Path parameters

iduuidrequired
The pull’s id: `result.pull.id` of a finished pull job, or an id from GET /reviews/pulls.

Query parameters

starsstringoptional
Ratings to keep, comma-separated, e.g. 1,2.
qstringoptional
Only reviews mentioning this, in the title or the text. 1–100 characters
store"apple" | "play"optional
appIdstringoptional
Only this app’s reviews. 1–200 characters
countrystringoptional
Only this storefront.
versionstringoptional
0–40 characters
fromstringoptional
Oldest review date, YYYY-MM-DD.
tostringoptional
Newest review date, YYYY-MM-DD.
replied"yes" | "no"optional
Only reviews the developer answered (yes) or did not (no). Google Play publishes replies; the App Store does not.
sort"date" | "rating" | "helpful"optionaldefault "date"
dir"desc" | "asc"optionaldefault "desc"
limitintegeroptionaldefault 100
1–500
offsetintegeroptionaldefault 0
0–1000000

#Returns

The answer as JSON, beside. Free, and does not count against your credits.

MCP: get_pull_reviews — Read the reviews an Appleak pull kept, a page at a time (up to 500), filtered by rating, keyword, storefront, app, version, date or developer reply. Each has its rating, title, text, date, storefront, version and helpful votes. Free.