scraper
Back to API docs

Overview

  • Overview

APIs

  • POSTReviews

App Store Reviews

1 credit per call

Get App Store reviews for one or more apps in one or more countries.

POST/api/v1/tools/app-store/reviews

Parameters

appsstring[]required

App Store links or numeric app IDs, such as "389801252", "id389801252", or "https://apps.apple.com/us/app/instagram/id389801252". Add at least one. Repeated apps are read once.

countriesstring[]

Two-letter App Store country codes, such as "us" or "gb". Defaults to ["us"]. The value "all" picks every App Store country. Each app is read in each country.

sortstring

Review order: "mostRecent", "mostHelpful", "highestRating", or "lowestRating". Defaults to "mostRecent".

ratingsnumber[]

Star ratings to keep, from 1 to 5. Each chosen rating has its own maxReviews limit. Omit for all ratings.

sinceDatestring

Keep reviews from this date on, such as "2026-01-31". A date and time is also accepted.

untilDatestring

Keep reviews up to this date, such as "2026-03-31". A date with no time includes the whole day. It must not be before sinceDate.

keywordsstring[]

Keep a review only when its title or text contains at least one of these words. Letter case is ignored.

excludeKeywordsstring[]

Drop a review when its title or text contains any of these words. Letter case is ignored.

developerReplystring

Keep reviews "with" a developer reply, "without" one, or "any". Defaults to "any".

editedstring

Keep reviews that the author "edited", reviews that are "notEdited", or "any". Defaults to "any".

maxReviewsnumber

The most reviews for each app, country, and chosen rating. Defaults to 100. Use 0 for every review. The whole call returns no more reviews than your plan allows, and never more than 100,000. A call with a limit above 0 that asks for more than your plan allows fails with max_reviews_exceeded.

includeAppDetailsboolean

Add the details of each app in each country, such as name, developer, rating, price, and version. Defaults to false.

Response Schema

dataobject

App Store reviews result

reviewsobject[]

Reviews in the order of the request. A field with no value is left out of the review.

countnumber

Number of reviews returned

notesstring[]

Why the result may be incomplete, such as an app that a country does not offer, a read that stopped early, or the review limit of the plan. Empty when every matching review was read.

appsobject[]

Present when includeAppDetails is true. One record for each app in each country that offers it: id, name, country, url, bundleId, iconUrl, developer, category, genres, price, formattedPrice, currency, version, releaseDate, currentVersionReleaseDate, releaseNotes, description, rating, ratingCount, ratingCurrentVersion, ratingCountCurrentVersion, contentRating, minimumOsVersion, languages, fileSizeBytes, screenshotUrls.

metaobject

Request metadata

toolstring

Tool name (app-store-reviews)

creditsUsednumber

Credits used: 1 per call

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/app-store/reviews \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "apps": ["https://apps.apple.com/us/app/instagram/id389801252"],
    "countries": ["us", "gb"],
    "ratings": [1, 2],
    "maxReviews": 50
  }'

Response Example

{
  "data": {
    "reviews": [
      {
        "id": "11223344556",
        "appId": "389801252",
        "appName": "Instagram",
        "country": "us",
        "rating": 2,
        "title": "Comments stay blank",
        "text": "Comments stay blank on every post since the last update.",
        "author": {
          "name": "jlee_22",
          "id": "987654321"
        },
        "date": "2026-11-08T14:21:09.000Z",
        "isEdited": false,
        "appVersion": "412.0",
        "helpfulVotes": 4,
        "totalVotes": 5
      },
      {
        "id": "11223344001",
        "appId": "389801252",
        "appName": "Instagram",
        "country": "gb",
        "rating": 1,
        "title": "Cannot log in",
        "text": "Since the last update the app asks me to log in again every day.",
        "author": {
          "name": "Sam from Leeds"
        },
        "date": "2026-11-07T08:02:44.000Z",
        "isEdited": true,
        "developerReply": {
          "text": "Sorry about this. Please update to the latest version and contact us if it continues.",
          "date": "2026-11-07T19:30:00.000Z"
        }
      }
    ],
    "count": 2,
    "notes": []
  },
  "meta": {
    "tool": "app-store-reviews",
    "creditsUsed": 1,
    "requestId": "req_abc123"
  }
}