Reviews

App Store & Google Play Reviews

User reviews for any iOS or Android app — rating, text, app version and developer replies.

app-store-reviewsapp-storegoogle-playreviewsiosandroidproduct-research

1,006 rows in the dataset

Download the dataset

Get every row this scraper has collected as one CSV or JSONL file. If the data is older than maxAgeHours, the scraper is re-run with its configured settings first. The key needs the datasets:export scope.

DOWNLOAD_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/datasets/app-store-reviews/downloads" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{"maxAgeHours":24,"format":"csv"}' | jq -r '.id')while true; do  STATUS=$(curl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY" | jq -r '.status')  [ "$STATUS" != "refreshing" ] && break  sleep 5donecurl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID/file" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -o dataset.csv

At its current 1,006 rows, this download costs 11 credits when the data is fresh enough, or 22 credits when it has to be refreshed first.

The rate is 1 credit per 100 rows cached and 2 credits live, charged on the rows in the dataset when the download becomes ready. A failed refresh is not charged. The file stays downloadable for 24 hours. See pricing.

Start a run

To choose the targets yourself, send the parameters below as input. The call returns 202 with the run; the key needs the scrapers:run scope and the account a positive credit balance.

curl -X POST "https://api.pandorlabs.com/v1/scrapers/app-store-reviews/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "targets": [        "apple:324684580",        "play:com.spotify.music"      ],      "ratings": [        "1",        "2"      ],      "keywords": [        "crash",        "subscription",        "export"      ],      "maxAgeDays": 0    }  }'

A run is billed at the live rate once it finishes: 2 credits per 100 rows it collected. A run that collects nothing costs nothing.

Parameters

Every parameter is optional. Anything you leave out uses the default shown here; an unknown name or an invalid value is rejected with a 400 that lists each problem.

Targeting

targets
string[]
Apps
One entry per app, as `store:appId`, `store:country:appId`, or a pasted App Store / Play Store URL.
Default
["apple:324684580","play:com.spotify.music"]
Example
apple:324684580, play:com.spotify.music
ratings
string[]
Star ratings
Keeps only these ratings. Empty keeps all five. `1, 2` is the setting that turns this into a complaint feed.
Default
none
Example
1, 2
keywords
string[]
Keywords
Keeps only reviews whose title or body contains one of these.
Default
none
Example
crash, subscription, export
maxAgeDays
number
Max age (days)
Drop reviews older than this. 0 keeps everything the store returns.
Default
0
Range
0 to 3650

Collection

maxReviewsPerApp
number
Max reviews per app
Apple caps its feed at 500 per storefront whatever this says; Google keeps paging.
Default
500
Range
1 to 10000
includeAppMetadata
boolean
Resolve app names
One extra request per Apple app. Google publishes no equivalent, so Play rows carry the package name only.
Default
true
concurrency
number
Concurrent apps
Default
3
Range
1 to 8
requestDelayMs
number
Delay between pages (ms)
Default
800
Range
0 to 30000

Input as JSON Schema

The same schema the API validates against. Use it as a tool input schema or to generate a typed client.

inputSchema

{  "type": "object",  "additionalProperties": false,  "properties": {    "targets": {      "type": "array",      "items": {        "type": "string"      },      "maxItems": 1000,      "title": "Apps",      "description": "One entry per app, as `store:appId`, `store:country:appId`, or a pasted App Store / Play Store URL.",      "default": [        "apple:324684580",        "play:com.spotify.music"      ],      "examples": [        "apple:324684580, play:com.spotify.music"      ]    },    "ratings": {      "type": "array",      "items": {        "type": "string"      },      "maxItems": 1000,      "title": "Star ratings",      "description": "Keeps only these ratings. Empty keeps all five. `1, 2` is the setting that turns this into a complaint feed.",      "default": [],      "examples": [        "1, 2"      ]    },    "keywords": {      "type": "array",      "items": {        "type": "string"      },      "maxItems": 1000,      "title": "Keywords",      "description": "Keeps only reviews whose title or body contains one of these.",      "default": [],      "examples": [        "crash, subscription, export"      ]    },    "maxAgeDays": {      "type": "number",      "minimum": 0,      "maximum": 3650,      "title": "Max age (days)",      "description": "Drop reviews older than this. 0 keeps everything the store returns.",      "default": 0    },    "maxReviewsPerApp": {      "type": "number",      "minimum": 1,      "maximum": 10000,      "title": "Max reviews per app",      "description": "Apple caps its feed at 500 per storefront whatever this says; Google keeps paging.",      "default": 500    },    "includeAppMetadata": {      "type": "boolean",      "title": "Resolve app names",      "description": "One extra request per Apple app. Google publishes no equivalent, so Play rows carry the package name only.",      "default": true    },    "concurrency": {      "type": "number",      "minimum": 1,      "maximum": 8,      "title": "Concurrent apps",      "default": 3    },    "requestDelayMs": {      "type": "number",      "minimum": 0,      "maximum": 30000,      "title": "Delay between pages (ms)",      "default": 800    }  }}

Run, poll, read rows

The run is asynchronous. Poll it until it reaches a terminal status and its billing is paid, then page through its rows. Until then the rows endpoint answers 409 (still queued or running) or 402 (payment required).

RUN_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/scrapers/app-store-reviews/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "targets": [        "apple:324684580",        "play:com.spotify.music"      ],      "ratings": [        "1",        "2"      ],      "keywords": [        "crash",        "subscription",        "export"      ],      "maxAgeDays": 0    }  }' | jq -r '.id')while true; do  RUN=$(curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY")  STATUS=$(echo "$RUN" | jq -r '.status')  BILLING=$(echo "$RUN" | jq -r '.billing.status')  case "$STATUS" in queued|running) ;; *) [ "$BILLING" != "pending" ] && break ;; esac  sleep 5doneecho "$RUN" | jq '{status, rowCount, billing}'curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID/rows?page=1&limit=100" \  -H "Authorization: Bearer $PANDORLABS_KEY"

See the API reference for pagination, cancelling and listing runs.

Output fields

Rows have no fixed schema; these are the fields observed in the rows collected so far. Coverage is the share of rows where the field is present.

Field	Type	Coverage
app_id	string	100%
app_name	string	47%
app_version	string	99%
author	string	100%
country	string	100%
developer_reply	string	17%
helpful_count	number	100%
rating	number	100%
review_id	string	100%
review_key	string	100%
source_url	string	53%
store	string	100%
text	string	100%
title	string	47%
created_at	date	100%
developer_reply_at	date	17%
first_seen_at	date	100%
last_seen_at	date	100%
reviewed_at	date	100%
updated_at	date	100%
_id	string	100%