API reference · Reviews

Pull reviews

Reviews Intelligence: read up to ten apps’ store reviews to an exact filter (ratings, words they must or must not mention, length, versions, dates) across the storefronts you name, keeping up to `limit` an app. The pull is filed in your Reviews Intelligence history like one started on the site. The job’s result is the pull; page through its reviews with GET /reviews/pulls/{id}/reviews.

POST/api/v1/reviews/pulls

Costs: 1 credit
MCP tool: start_review_pull
Answers: A job, at once (202)

curl "https://appleak.app/api/v1/reviews/pulls" \
  -H "Authorization: Bearer $APPLEAK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "apps": [
      {
        "store": "apple",
        "appId": "1234567890"
      }
    ],
    "stars": [
      1,
      2
    ],
    "keywords": [
      "crash",
      "subscription"
    ],
    "limit": 200,
    "countries": [
      "us",
      "gb"
    ]
  }'

Response202 Accepted

{
  "id": "6f1c2b9e-1d0a-4c55-9a51-2b7f0c3e8d41",
  "object": "job",
  "kind": "reviews",
  "status": "queued",
  "credits": 1,
  "refunded": false,
  "progress": null,
  "createdAt": "2026-10-19T12:00:00.000Z",
  "startedAt": null,
  "finishedAt": null,
  "error": null,
  "result": null,
  "links": {
    "self": "/api/v1/jobs/6f1c2b9e-1d0a-4c55-9a51-2b7f0c3e8d41"
  }
}

#Parameters

Body parameters

apps{ store, appId }[]required
The apps to read, up to 10. search_apps or /reviews/scan finds them. 1–10 items
starsinteger[]optional
Ratings to keep, e.g. [1, 2]. Leave out for every rating. 1–5 items
keywordsstring[]optional
Keep only reviews that mention these words, in the title or the text. 0–24 items
keywordMode"any" | "all"optionaldefault "any"
any: a review mentions at least one keyword; all: every one.
excludestring[]optional
Drop reviews that mention any of these. 0–24 items
requireTextbooleanoptionaldefault false
Drop ratings left without any words.
minLengthintegeroptionaldefault 0
Shortest review text to keep, in characters. 0–5000
versionsstring[]optional
Keep only these app versions; 7. matches 7.14.2. 0–24 items
sincestringoptional
Oldest review date to keep, YYYY-MM-DD.
untilstringoptional
Newest review date to keep, YYYY-MM-DD.
limitintegeroptionaldefault 200
Reviews to keep per app, after the filter. 1–5000
countriesstring[]optionaldefault ["us"]
Storefronts to read, as two-letter codes. 1–200 items
languagesstring[]optional
Google Play only: the review languages to read, e.g. ["en", "de"]. English when left out. An App Store storefront implies its language. 1–80 items
sort"recent" | "helpful"optionaldefault "recent"
Read newest first, or most helpful first.
labelstringoptional
A name for the pull in your history. 0–120 characters
forcebooleanoptional
Start a new run even when the same one is already queued or running for you.

#Returns

A job, straight away, with status queued. Follow it with GET /jobs/{id} until it is done; the finished job carries the result.

MCP: start_review_pull — Start an Appleak Reviews Intelligence pull: up to 10 App Store or Google Play apps’ reviews, filtered by rating, keywords, length, version and date, across chosen storefronts. Spends credits; returns a job id. get_job gives the pull and its counts, then get_pull_reviews pages through the reviews.