Apple App Store App Reviews
Apple App Store app reviews are public customer feedback records with written text, ratings, reviewer identity, publication time, and links to the reviewed app. These records support feedback analysis, rating comparisons, app-catalog enrichment, and time-based monitoring.
Features
- Known app URL batchesSubmit one or more apps.apple.com product URLs in a single task and set one results_limit for the total review records saved from that request.
- Normalized public review recordsRead review text, numeric rating, reviewer identity, optional media, and stable record fields through the shared review schema.
- App and collection contextAssociate each available review with its subject identifier or app URL while retaining publication and collection timestamps for traceable snapshots.
Parameters
| Parameters | Required | Description |
|---|---|---|
urls | Required | Required list of non-empty app references whose parsed hostname is apps.apple.com or a subdomain; absolute and protocol-relative values are accepted, separated by commas or new lines in the Playground. |
results_limit | Optional | Optional positive integer from 1 through 2,000 that caps the total review records stored for the task; the backend default is 100. |
How to Use
Submit known app URLs, track the asynchronous task, and page through the review records stored for the completed task.
- Prepare at least one app reference whose parsed hostname is apps.apple.com and optionally choose a results_limit from 1 through 2,000.
- POST the payload to /v1/apple-app-store/app-reviews and save the returned task_id.
- Poll GET /v1/tasks/{task_id} until the status is succeeded or failed.
- Read data.results.items and continue with next_cursor while has_more is true.
curl -X POST "https://api.socq.ai/v1/apple-app-store/app-reviews" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://apps.apple.com/us/app/chatgpt/id6448311069"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueBest Use Cases
- App feedback review: Use written review text, rating values, and reviewer context to inspect the public feedback returned for known app pages.
- Cross-app rating comparison: Group normalized records by subject identifier or app URL, then compare rating distributions across the submitted products.
- Review timeline snapshots: Retain publication and collection timestamps with review IDs to distinguish newly collected records from earlier snapshots.
Pro Tips
- Validate every input for an apps.apple.com hostname before submission; subdomains and protocol-relative references are accepted, while other hosts are rejected.
- Choose results_limit for the combined task rather than per app; omitted requests use 100 and the accepted range ends at 2,000.
- Follow next_cursor only to read additional stored SocQ results; it does not request another provider page or continue upstream collection.
- Treat missing text, author details, rating, app references, or media as unknown and omit null fields from downstream displays.
Related APIs
Use these APIs when you need a different type of public Apple App Store data.
- Apple App Store App Detail API — Retrieve normalized public app identity, descriptive metadata, developer and category context, visible ratings, pricing, and media from known App Store listing URLs.
- Apple App Store Rankings API — Collect public category chart entries from supported Apple App Store URLs with source rank, app identity, developer, rating, review count, price, and media fields.