apple-app-store/
app-reviews

The Apple App Store App Reviews API collects public Apple App Store reviews from one or more apps.apple.com URLs, returning review text, ratings, reviewer details, timestamps, and app context as normalized records.

Apple App Store App Reviews API

Known app URLs
Public review text and ratings
Reviewer and app context
0.15 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

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.

Apple App Store App Reviews API 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.

Apple App Store App Reviews API Parameters

ParametersRequiredDescription
urlsRequiredRequired 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_limitOptionalOptional 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 the Apple App Store App Reviews API

Submit known app URLs to the Apple App Store App Reviews API, track the asynchronous task, and page through the review records stored for the completed task.

  1. Prepare at least one app reference whose parsed hostname is apps.apple.com and optionally choose a results_limit from 1 through 2,000.
  2. POST the payload to /v1/apple-app-store/app-reviews and save the returned task_id.
  3. Poll GET /v1/tasks/{task_id} until the status is succeeded or failed.
  4. 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 true

Apple App Store App Reviews API Use Cases

  • App feedback review: Use written review text, rating values, and reviewer context from the Apple App Store App Reviews API 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.

Apple App Store App Reviews API 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.

Beyond the Apple App Store App Reviews API, 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.

Explore other platforms

Combine Apple App Store data with public data from other supported social platforms.

Apple App Store App Reviews API — FAQ

Apple App Store App Reviews API is a programmatic interface for collecting public customer reviews from known Apple App Store app URLs. It returns normalized review text, ratings, reviewer details, timestamps, media, and app references when available.

urls is required and must contain one or more non-empty references whose parsed hostname is apps.apple.com or a subdomain; absolute and protocol-relative forms are accepted. results_limit is optional, defaults to 100, and accepts integers from 1 through 2,000.

No. results_limit caps the total records stored for the task across the submitted URL list, so divide separate collection goals into separate tasks when independent caps matter.

No. next_cursor pages through records already stored by SocQ after the task succeeds; the public request does not expose a provider cursor for additional upstream pages.

The Apple App Store App Reviews API charges 0.15 SocQ credits for each successfully stored review, with a 100-result estimate when results_limit is omitted. A task with no stored reviews has no result charge because the configured base charge is zero.