# App Store App Reviews API (https://www.socialcrawl.dev/platforms/app_store/app-reviews)

> Returns a unified ReviewList of Apple App Store user reviews for an app, keyed by its numeric `app_id` (on every review's `entity_id`). Each review carries the star rating, full text, review title, reviewer name, and publish date — on the SAME canonical `Review` shape used by Amazon, Google Shopping, and Trustpilot. Apple reviews have no avatar, helpful-vote count, or developer responses (those are null). `depth` returns reviews in batches of 50 (max 600). Sourced from DataForSEO's task-based App Data API.

TL;DR: `GET /v1/app_store/app-reviews` costs 5 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `app_id` | yes | Apple App Store numeric app id (e.g. '324684580'), from app-search. |
| `country` | no | Storefront country as a DFS location name or numeric code. Defaults to the US. |
| `language` | no | Language code (e.g. 'en'). Defaults to 'en'. |
| `depth` | no | Number of reviews to retrieve (default 50, batches of 50, max 600). |
| `sort_by` | no | Review ordering: `most_recent` (default) or `most_helpful`. (most_recent \| most_helpful) |
| `rating` | no | Filter to a single star rating (1–5). |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/app_store/app-reviews?app_id=324684580" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get Apple App Store reviews via API?

Send a GET request to /v1/app_store/app-reviews with the numeric app id like 324684580. The response is a unified ReviewList with each review's star rating, title, full text, author name, and publish date, in the shared Review schema.

### Do Apple App Store reviews include developer replies?

No. Apple App Store reviews carry a title but no helpful-vote count, no avatar, and no developer responses — those fields come back null. You get the star rating, review title, full text, author, and date, which is what Apple exposes publicly.

### What fields does each App Store review include?

Every review carries a star rating (value and max), a review title, the review text, the author name, and the publish date — all in the shared Review schema used by Amazon, Google Shopping, and Trustpilot. Helpful votes and developer replies are null for Apple.

### How much does the App Store reviews endpoint cost?

Reviews run on the advanced tier at 5 credits per call. New accounts get 100 free credits with no card, and an app id with no reviews returns a not-found response that is refunded automatically.

### Can I control how many reviews I get back?

Yes. An optional depth parameter pulls reviews in batches of 50 up to 600, and you can sort by most_recent or most_helpful or filter to a single star rating. Pass the numeric app id from app-search to target a specific app.

See the full App Store API: https://www.socialcrawl.dev/platforms/app_store

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to get Apple App Store reviews with an API
- Do App Store reviews from the SocialCrawl API include developer replies?