100 free credits. No credit card required
Prism App Reviews API
Returns Google Play and App Store reviews together: rating summaries, topic clusters, sentiment over time, feature requests, and how often the developer replies.
GET /v1/prism/app-reviewsLast updated October 2026Maintained by the SocialCrawl team
When to use the Prism App Reviews API
Use it to read an app's feedback in one call; apps-lookup compares the two store listings, this covers what reviewers actually wrote.
Not for one store's raw review rows (google_play/app-reviews, app_store/app-reviews) or a shop product's reviews (prism/product-reviews).
From the API reference
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 review legs plus clustering run ~30s). Single-store calls are 10 credits; both stores 15.
Searching 69 platforms in parallel
·
TikTok·
Instagram·
YouTube·
Facebook·
X·
LinkedIn·
Reddit·
Threads·
Pinterest·
Twitch·
Truth Social·
Snapchat·
Kick·
Bluesky·
Kwai·
Rumble·
Spotify·
Apple Music·TikTok Shop·
Amazon Shop·
Google Shopping·
Trustpilot·
TripAdvisor·
Yelp·
Linktree·
Komi·
Pillar·
lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·
Finance·
Polymarket·
Tavily·
Hacker News·
GitHub·
Perplexity·
Naver·
Utility·
Universal Search
TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search
TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search
TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search
TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal SearchPrism API
What can you do with the App Reviews API?
The App Reviews endpoint gives you structured Prism data with computed fields in a single request. No scraping infrastructure to build or maintain.
Example Request
# GET /v1/prism/app-reviews: Metered: holds 15 credits per call up front and refunds what the call does not use. Cache hits are free and failed calls are refunded.
# Check the price first for 0 credits: add dry_run=1 to the query. Nothing is fetched or charged.
# --max-time 60: the API's own time limit for this endpoint.
# --retry 3: retries timeouts, 429 and 5xx, honoring Retry-After.
# -o response.json keeps only the final attempt's body.
# One Idempotency-Key per request, reused on every retry, so a retried call is never charged twice.
IDEMPOTENCY_KEY=$(od -An -N16 -tx1 /dev/urandom | tr -d ' \n')
curl -sS --max-time 60 --retry 3 -o response.json \
-H "x-api-key: YOUR_API_KEY" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
"https://www.socialcrawl.dev/v1/prism/app-reviews?query=spotify&depth=150" && cat response.json# GET /v1/prism/app-reviews: Metered: holds 15 credits per call up front and refunds what the call does not use. Cache hits are free and failed calls are refunded.
# Check the price first for 0 credits: add dry_run=1 to the query. Nothing is fetched or charged.
import os
import random
import time
import uuid
import requests
API_KEY = os.environ.get("SOCIALCRAWL_API_KEY", "YOUR_API_KEY")
TIMEOUT_S = 60 # the API's own time limit for this endpoint.
MAX_RETRIES = 3
URL = "https://www.socialcrawl.dev/v1/prism/app-reviews"
def backoff(attempt):
# Exponential backoff with jitter: about 1 s, 2 s, then 4 s.
return 2 ** attempt * (0.5 + random.random() / 2)
def socialcrawl(params):
# One Idempotency-Key per request, reused on every retry, so a retried call is never charged twice.
idempotency_key = str(uuid.uuid4())
for attempt in range(MAX_RETRIES + 1):
try:
res = requests.get(
URL,
params=params,
headers={"x-api-key": API_KEY, "Idempotency-Key": idempotency_key},
timeout=TIMEOUT_S,
)
body = res.json()
except (requests.RequestException, ValueError):
# A timeout, a dropped connection or a non-JSON gateway page: retry with the same key.
if attempt == MAX_RETRIES:
raise
time.sleep(backoff(attempt))
continue
if body["success"]:
return body
error = body["error"]
# Branch on error["type"], never on the message text.
if error["type"] == "RESOURCE_NOT_FOUND":
return None # refunded: nothing to read
retry_after = res.headers.get("Retry-After")
# SERVICE_UNAVAILABLE without Retry-After is a withdrawn endpoint: permanent.
permanent = error["type"] == "SERVICE_UNAVAILABLE" and retry_after is None
if not error.get("retryable") or permanent or attempt == MAX_RETRIES:
raise RuntimeError(f"{error['type']}: {error['message']} (request_id {body['request_id']})")
# Retry-After (seconds) wins; otherwise back off.
time.sleep(float(retry_after) if retry_after else backoff(attempt))
params = {
"query": "spotify",
"depth": "150",
}
body = socialcrawl(params)
if body is not None:
print(body["data"])// GET /v1/prism/app-reviews: Metered: holds 15 credits per call up front and refunds what the call does not use. Cache hits are free and failed calls are refunded.
// Check the price first for 0 credits: add dry_run=1 to the query. Nothing is fetched or charged.
const API_KEY = process.env.SOCIALCRAWL_API_KEY ?? "YOUR_API_KEY";
const TIMEOUT_MS = 60_000; // the API's own time limit for this endpoint.
const MAX_RETRIES = 3;
type Page = { next_cursor: string | null; has_more: boolean };
type SocialCrawlResponse =
| { success: true; data: any; pagination?: Page; credits_used: number; request_id: string }
| { success: false; error: { type: string; message: string; retryable: boolean }; request_id: string };
const sleep = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));
// Exponential backoff with jitter: about 1 s, 2 s, then 4 s.
const backoffMs = (attempt: number) => 2 ** attempt * 1000 * (0.5 + Math.random() / 2);
async function socialcrawl(url: URL) {
// One Idempotency-Key per request, reused on every retry, so a retried call is never charged twice.
const idempotencyKey = crypto.randomUUID();
for (let attempt = 0; ; attempt++) {
let res: Response;
let body: SocialCrawlResponse;
try {
res = await fetch(url, {
headers: {
"x-api-key": API_KEY,
"Idempotency-Key": idempotencyKey,
},
signal: AbortSignal.timeout(TIMEOUT_MS),
});
body = (await res.json()) as SocialCrawlResponse;
} catch (error) {
// A timeout, a dropped connection or a non-JSON gateway page: retry with the same key.
if (attempt >= MAX_RETRIES) throw error;
await sleep(backoffMs(attempt));
continue;
}
if (body.success) return body;
// Branch on error.type, never on the message text.
if (body.error.type === "RESOURCE_NOT_FOUND") return null; // refunded: nothing to read
const retryAfter = res.headers.get("Retry-After");
// SERVICE_UNAVAILABLE without Retry-After is a withdrawn endpoint: permanent.
const permanent = body.error.type === "SERVICE_UNAVAILABLE" && retryAfter === null;
if (!body.error.retryable || permanent || attempt >= MAX_RETRIES) {
throw new Error(`${body.error.type}: ${body.error.message} (request_id ${body.request_id})`);
}
// Retry-After (seconds) wins; otherwise back off.
await sleep(retryAfter ? Number(retryAfter) * 1000 : backoffMs(attempt));
}
}
const url = new URL("https://www.socialcrawl.dev/v1/prism/app-reviews");
url.searchParams.set("query", "spotify");
url.searchParams.set("depth", "150");
const body = await socialcrawl(url);
if (body) console.log(body.data);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, as a location name or numeric code (look one up with `GET /v1/app_store/locations` or `GET /v1/google_play/locations`). Defaults to United States. |
| 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. |
Example Response
What does the Prism App Reviews API return?
Every response follows one unified schema. Here is a real, unmodified response body, so you can see the exact fields you get back before spending a credit.
Example response
{
"success": true,
"platform": "prism",
"endpoint": "/v1/prism/app-reviews",
"data": {
"reviews": {
"google_play": [
{
"id": "4078c762-cba1-417b-8858-3737b709cefc",
"entity_id": "com.spotify.music",
"url": null,
"title": null,
"text": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"rating": {
"value": 5,
"max": 5
},
"author": {
"name": "user_270a6f",
"avatar_url": "https://example.com/avatars/user_76b01d.png",
"url": null,
"location": null,
"reviews_count": null
},
"helpful_votes": null,
"verified": null,
"source": null,
"language": null,
"original_language": null,
"translated": null,
"images": null,
"responses": null,
"published_at": "2026-10-01T15:46:47.000Z",
"ext": {
"appdata": {
"type": "Sample comment text (redacted).",
"rank_group": 1,
"rank_absolute": 1,
"position": "Sample comment text (redacted).",
"version": null,
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
},
"timestamp": "2026-10-01T15:46:47.000Z",
"id": "4078c762-cba1-417b-8858-3737b709cefc",
"helpful_count": null,
"title": null,
"review_text": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"user_profile": {
"profile_name": "user_270a6f",
"profile_image_url": "https://example.com/avatars/user_76b01d.png"
},
"responses": null,
"entity_id": "com.spotify.music"
}
}
},
{
"id": "57b99e1b-e1ba-4079-8b75-3216e4120ab1",
"entity_id": "com.spotify.music",
"url": null,
"title": null,
"text": "Sample comment text (redacted).",
"rating": {
"value": 5,
"max": 5
},
"author": {
"name": "user_14445f",
"avatar_url": "https://example.com/avatars/user_886ea7.png",
"url": null,
"location": null,
"reviews_count": null
},
"helpful_votes": null,
"verified": null,
"source": null,
"language": null,
"original_language": null,
"translated": null,
"images": null,
"responses": null,
"published_at": "2026-10-01T15:45:37.000Z",
"ext": {
"appdata": {
"type": "Sample comment text (redacted).",
"rank_group": 2,
"rank_absolute": 2,
"position": "Sample comment text (redacted).",
"version": "Sample comment text (redacted).",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
},
"timestamp": "2026-10-01T15:45:37.000Z",
"id": "57b99e1b-e1ba-4079-8b75-3216e4120ab1",
"helpful_count": null,
"title": null,
"review_text": "Sample comment text (redacted).",
"user_profile": {
"profile_name": "user_14445f",
"profile_image_url": "https://example.com/avatars/user_886ea7.png"
},
"responses": null,
"entity_id": "com.spotify.music"
}
}
}
],
"app_store": [
{
"id": "1344893011",
"entity_id": "324684580",
"url": null,
"title": "Sample comment text (redacted).",
"text": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"rating": {
"value": 5,
"max": 5
},
"author": {
"name": "user_d7c0de",
"avatar_url": null,
"url": null,
"location": null,
"reviews_count": null
},
"helpful_votes": null,
"verified": null,
"source": null,
"language": null,
"original_language": null,
"translated": null,
"images": null,
"responses": null,
"published_at": "2026-10-01T00:00:00.000Z",
"ext": {
"appdata": {
"type": "app_store_reviews_search",
"rank_group": 1,
"rank_absolute": 1,
"position": "Sample comment text (redacted).",
"version": "Sample comment text (redacted).",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
},
"timestamp": "2026-10-01T00:00:00.000Z",
"id": "1404300885",
"title": "Sample comment text (redacted).",
"review_text": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"user_profile": {
"profile_name": "user_d7c0de",
"profile_image_url": null
},
"entity_id": "324684580"
}
}
},
{
"id": "1192065862",
"entity_id": "324684580",
"url": null,
"title": "Sample comment text (redacted).",
"text": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"rating": {
"value": 3,
"max": 5
},
"author": {
"name": "user_51c300",
"avatar_url": null,
"url": null,
"location": null,
"reviews_count": null
},
"helpful_votes": null,
"verified": null,
"source": null,
"language": null,
"original_language": null,
"translated": null,
"images": null,
"responses": null,
"published_at": "2026-10-01T00:00:00.000Z",
"ext": {
"appdata": {
"type": "app_store_reviews_search",
"rank_group": 2,
"rank_absolute": 2,
"position": "Sample comment text (redacted).",
"version": "Sample comment text (redacted).",
"rating": {
"rating_type": "Max5",
"value": 3,
"votes_count": null,
"rating_max": 5
},
"timestamp": "2026-10-01T00:00:00.000Z",
"id": "2347278356",
"title": "Sample comment text (redacted).",
"review_text": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"user_profile": {
"profile_name": "user_51c300",
"profile_image_url": null
},
"entity_id": "324684580"
}
}
}
]
},
"apps": {
"google_play": {
"id": "com.spotify.music",
"store": "google_play",
"url": "https://play.google.com/store/apps/details?id=com.spotify.music",
"title": "Spotify: Music and Podcasts",
"subtitle": null,
"icon": "https://play-lh.googleusercontent.com/IzQgYCcnCFCD08GR-3bdtcT8xzOvrNkC84avGT5CwTX2VIqmTmKKJcP_Cd4JoBOdmCMlTndlOzV6hrthg2fOWA",
"description": null,
"developer": {
"id": null,
"name": "Spotify AB",
"url": null,
"email": null,
"address": null,
"website": null
},
"rating": {
"value": 4.3,
"max": 5,
"count": 36415715
},
"price": {
"current": 0,
"original": null,
"currency": "USD",
"is_free": true,
"displayed": null
},
"reviews_count": 36415715,
"category": null,
"categories": null,
"installs": null,
"version": null,
"minimum_os_version": null,
"size": null,
"released_at": null,
"updated_at": null,
"update_notes": null,
"image_urls": null,
"ext": {
"appdata": {
"type": "google_play_search_organic",
"rank_group": 1,
"rank_absolute": 1,
"position": "left",
"app_id": "com.spotify.music",
"title": "Spotify: Music and Podcasts",
"url": "https://play.google.com/store/apps/details?id=com.spotify.music",
"icon": "https://play-lh.googleusercontent.com/IzQgYCcnCFCD08GR-3bdtcT8xzOvrNkC84avGT5CwTX2VIqmTmKKJcP_Cd4JoBOdmCMlTndlOzV6hrthg2fOWA",
"reviews_count": 36415715,
"rating": {
"rating_type": "Max5",
"value": 4.3,
"votes_count": 36415715,
"rating_max": 5
},
"is_free": true,
"price": {
"current": 0,
"regular": null,
"max_value": null,
"currency": "USD",
"is_price_range": false,
"displayed_price": null
},
"developer": "Spotify AB",
"developer_url": null
}
}
},
"app_store": {
"id": "324684580",
"store": "app_store",
"url": "https://apps.apple.com/us/app/spotify-music-and-podcasts/id324684580",
"title": "Spotify: Music and Podcasts",
"subtitle": null,
"icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/5f/b6/e0/5fb6e0c6-cea6-e107-8d54-8e8fcec573ce/AppIcon-0-0-1x_U007epad-0-1-0-0-sRGB-85-220.png/512x512bb.jpg",
"description": null,
"developer": {
"id": null,
"name": null,
"url": null,
"email": null,
"address": null,
"website": null
},
"rating": {
"value": 4.8,
"max": 5,
"count": 42379565
},
"price": {
"current": 0,
"original": null,
"currency": "USD",
"is_free": true,
"displayed": null
},
"reviews_count": 42379565,
"category": null,
"categories": null,
"installs": null,
"version": null,
"minimum_os_version": null,
"size": null,
"released_at": null,
"updated_at": null,
"update_notes": null,
"image_urls": null,
"ext": {
"appdata": {
"type": "app_store_search_organic",
"rank_group": 1,
"rank_absolute": 1,
"position": "left",
"app_id": "324684580",
"title": "Spotify: Music and Podcasts",
"url": "https://apps.apple.com/us/app/spotify-music-and-podcasts/id324684580",
"icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/5f/b6/e0/5fb6e0c6-cea6-e107-8d54-8e8fcec573ce/AppIcon-0-0-1x_U007epad-0-1-0-0-sRGB-85-220.png/512x512bb.jpg",
"reviews_count": 42379565,
"rating": {
"rating_type": "Max5",
"value": 4.8,
"votes_count": 42379565,
"rating_max": 5
},
"is_free": true,
"price": {
"current": 0,
"regular": null,
"max_value": null,
"currency": "USD",
"is_price_range": false,
"displayed_price": null
}
}
}
}
},
"rating_summary": {
"google_play": {
"value": 4.3,
"max": 5,
"count": 36415715
},
"app_store": {
"value": 4.8,
"max": 5,
"count": 42379565
}
},
"dev_response_rate": {
"google_play": {
"responded": 1,
"total": 150,
"rate": 0.006666666666666667
},
"app_store": {
"responded": 0,
"total": 150,
"rate": 0
}
},
"legs": [
{
"endpoint": "/v1/google_play/app-search",
"status": 200,
"credits_used": 5,
"latency_ms": 5322,
"error": null
},
{
"endpoint": "/v1/app_store/app-search",
"status": 200,
"credits_used": 5,
"latency_ms": 8096,
"error": null
}
],
"coverage": 1,
"partial_failure": false,
"topics_coverage": {
"reviews": 300,
"filed": 248,
"other": 45,
"uncertain": 7,
"unjudged": 0
},
"methodology_version": "app-reviews-v3",
"topics": [
{
"label": "General praise",
"count": 139,
"share": 0.4633333333333333,
"avg_rating": 4.928057553956834,
"sentiment": "positive",
"sentiment_score": 0.9618884892086336,
"sample_review_ids": [
"57b99e1b-e1ba-4079-8b75-3216e4120ab1",
"eb177431-2b99-480c-b13a-9a37772cf8d6"
],
"review_ids": [
"57b99e1b-e1ba-4079-8b75-3216e4120ab1",
"eb177431-2b99-480c-b13a-9a37772cf8d6"
]
},
{
"label": "Excessive or loud ads",
"count": 39,
"share": 0.13,
"avg_rating": 3.102564102564102,
"sentiment": "negative",
"sentiment_score": 0.31320512820512814,
"sample_review_ids": [
"21dd6590-1e6f-4e71-adde-360da1f01918",
"281a48b4-95e8-4f31-af10-da9f5dd70556"
],
"review_ids": [
"21dd6590-1e6f-4e71-adde-360da1f01918",
"281a48b4-95e8-4f31-af10-da9f5dd70556"
]
}
],
"feature_requests": [
{
"request": "Reduce ad frequency",
"count": 30,
"stores": [
"google_play",
"app_store"
],
"sample_review_id": "281a48b4-95e8-4f31-af10-da9f5dd70556",
"review_ids": [
"281a48b4-95e8-4f31-af10-da9f5dd70556",
"7ec99b7b-785c-4634-aa85-fc601c908fbd"
]
},
{
"request": "Allow free users to choose and skip songs",
"count": 5,
"stores": [
"google_play",
"app_store"
],
"sample_review_id": "8f2ff5a5-c607-4c1e-80b7-0e1464f48050",
"review_ids": [
"8f2ff5a5-c607-4c1e-80b7-0e1464f48050",
"6c812c09-ef83-4e8f-bc98-408c9fb15fec"
]
}
],
"sentiment_timeline": [
{
"date": "2026-09-30",
"positive": 3,
"neutral": 0,
"negative": 1,
"avg_rating": 4.25
},
{
"date": "2026-10-01",
"positive": 218,
"neutral": 26,
"negative": 52,
"avg_rating": 4.054054054054054
}
],
"entity_resolution": {
"google_play": {
"candidates_seen": 5,
"flagged_indexes": [],
"methodology_version": "entity-resolve-v1",
"resolved_by": "judge",
"index": 0,
"title": "Spotify: Music and Podcasts",
"confidence": 0.81,
"probability": 0.85,
"same_as_top_hit": true
},
"app_store": {
"candidates_seen": 5,
"flagged_indexes": [],
"methodology_version": "entity-resolve-v1",
"resolved_by": "judge",
"index": 0,
"title": "Spotify: Music and Podcasts",
"confidence": 1,
"probability": 1,
"same_as_top_hit": true
},
"methodology_version": "entity-resolve-v1"
}
},
"credits_used": 15,
"request_id": "req_example000000",
"cached": false,
"credits_remaining": 9999,
"source": "captured",
"captured_at": "2026-10-02T15:47:18.486Z",
"redacted": true
}Live sample illustrating the unified response shape. Field values reflect the record you query.
API Details
How does the Prism App Reviews API work?
Send a GET request with your API key and get back clean, structured JSON in our unified schema. Supported computed fields are populated when the source provides the required inputs.
Method
GET
Response
JSON
Developer First
How do you scrape social media data in seconds?
The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 69 platforms covering 10B+ monthly active users.
One schema, every platform
Query 69 platforms with identical response structures. Write your integration once.
Computed fields, not just scraped
When an endpoint supports these metrics and the source provides the required inputs, the normalized record includes engagement_rate, estimated_reach, content_category, and language. Ready to use.
See your data before you code
Visual Data Explorer. Paste any URL, get rich result cards, sortable tables, CSV export.
import requests
response = requests.get(
'https://www.socialcrawl.dev/v1/tiktok/profile',
params={'handle': 'charlidamelio'},
headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json()[ .JSON ]
{
"success": true,
"platform": "tiktok",
"data": {
"author": {
"username": "charlidamelio",
"followers": 152400000
},
"engagement": {
"likes": 12400000000,
"engagement_rate": 0.087
},
"metadata": {
"language": "en",
"content_category": "lifestyle"
}
}
}FAQ
Have a question? We got answers
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usHow 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.
Ask AI about SocialCrawl
Ready to scrape Prism App Reviews data?
Get your API key and start pulling Prism data in under 60 seconds.