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

> One call returns a topic-clustered, sentiment-classified review report across Google Play and the App Store: per-store rating summary (listed aggregate), topic clusters, a pooled daily sentiment timeline, extracted feature requests, and developer-response rate — plus every raw review on the shared canonical Review shape. Resolve by store app_id (com.spotify.music / 324684580) or by `query` to auto-resolve the top app on each requested store. Sync by default; streams Server-Sent Events when the client sends `Accept: text/event-stream` (the DFS review legs + clustering run ~30s). Single-store calls are 10 credits; both stores 15.

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

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `google_play_id` | no | Google Play package name (e.g. com.spotify.music). |
| `app_store_id` | no | App Store numeric app id (e.g. 324684580). |
| `query` | no | App name to auto-resolve the top hit on each requested store (when no id is given). |
| `country` | no | Storefront country (DFS location name or numeric code). Defaults to the DFS default location. |
| `language` | no | Language code (e.g. en). |
| `depth` | no | Reviews per store (default 150 Google / 50 Apple, max 600). The App Store returns ~50 at depth 40. |
| `stores` | no | CSV subset of google_play,app_store. Defaults to whichever ids/query resolve. |
| `include` | no | CSV of topics,sentiment_timeline,feature_requests,responses (default all). Omitting topics+feature_requests skips the LLM step. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/prism/app-reviews" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get app reviews from both app stores in one call?

Send GET /v1/prism/app-reviews?query=<app name> with your API key. The app reviews API resolves the top app on Google Play and the App Store, pulls each store's reviews, and returns them on one shared schema — you never call two different APIs or merge two shapes yourself.

### Does the app reviews API analyze sentiment and topics?

Yes. A single model pass clusters the pooled reviews into labeled topics and extracts feature requests, while counts and average ratings are recomputed in code from the assigned reviews rather than trusted from the model. You also get a daily sentiment timeline and a per-store rating summary.

### Can I look up an app by name instead of a store id?

Yes. Pass query=<app name> and the endpoint resolves the top hit on each requested store, or pass google_play_id and app_store_id directly for an exact match. The country, language, and depth parameters control the storefront and how many reviews are pulled per store.

### How is the app reviews API priced?

It is a flat 15 credits for both stores and 10 for a single store. If one store's review leg fails on a both-store call, 5 credits are refunded automatically; if every review leg fails, the whole call is refunded. A failed clustering step never costs extra.

### Can I stream the review report as it builds?

Yes. Send Accept: text/event-stream and each store's reviews plus the clustered report arrive as typed SSE chunks, ending with a done chunk that reports the credits used. The default application/json returns one synchronous envelope with the full report.

See the full Prism API: https://www.socialcrawl.dev/platforms/prism

## 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:

- Which API returns Google Play and App Store reviews with sentiment in one call?
- How do I pull app store reviews and cluster them by topic with an API?