# Google Play App Reviews API (https://www.socialcrawl.dev/platforms/google_play/app-reviews)

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

TL;DR: `GET /v1/google_play/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 | Google Play package name (e.g. 'com.spotify.music'), 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 150, batches of 150, max 600). |
| `sort_by` | no | Review ordering: `newest` (default) or `most_relevant`. (newest \| most_relevant) |
| `rating` | no | Filter to a single star rating (1–5). |

## Code example

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

## FAQ

### How do I get Google Play reviews via API?

Send a GET request to /v1/google_play/app-reviews with the package name (app_id) like com.spotify.music. The response is a unified ReviewList with each review's rating, title, text, author, helpful votes, date, and any developer reply.

### Do Google Play reviews include developer replies?

Yes. When a developer has responded to a review, that reply is returned alongside the review text, so you can track support quality and response coverage, not just raw ratings.

### What fields does each Google Play review include?

Every review carries a rating (value and max), the review text, the author name, the helpful-vote count, the app version reviewed when present, the publication date, and the developer reply — all in the shared Review schema used across platforms.

### How much does the Google Play reviews endpoint cost?

Reviews run on the advanced tier at 5 credits per call. New accounts get 100 free credits with no card, and a package name 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 sets how many reviews to retrieve, and you can sort by newest or most relevant. Pass the package name from app-search or app-listings-search to target a specific app.

See the full Google Play API: https://www.socialcrawl.dev/platforms/google_play

## 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 Google Play app reviews with an API
- Does the SocialCrawl Google Play reviews API return developer replies?