Google Play App Reviews
Google Play App Reviews are public app-store evaluations that pair written feedback and star ratings with reviewer identity, publication time, and the reviewed app reference. These records support feedback research, rating comparison, release monitoring, and source-linked review datasets.
Features
- Multi-app URL inputAccept one or more play.google.com app URLs and allocate the requested review count across the submitted apps.
- Review content and ratingReturn each available review's text and numeric rating in a consistent review record.
- Reviewer and time contextPreserve available reviewer identity, profile reference, publication time, and collection time with the feedback.
- Reviewed-app traceabilityLink normalized reviews to available app identifiers and public app URLs through subject_id and subject_url.
Parameters
| Parameters | Required | Description |
|---|---|---|
urls | Required | Required array of one or more non-empty app URLs on play.google.com or its subdomains. |
country | Optional | Optional string passed to the review source as country context; omit it when no market context is required. |
results_limit | Optional | Optional positive integer from 1 through 2,000. It defaults to 100 and caps total stored results across all submitted URLs. |
How to Use
Submit Google Play app URLs, track the asynchronous task, and page through the normalized records stored by SocQ.
- Prepare one or more public app URLs whose hostname is play.google.com or one of its subdomains.
- POST urls with an optional country and results_limit to /v1/google-play/app-reviews, then save the returned task_id.
- Poll /v1/tasks/{task_id} until the task succeeds or fails; do not submit another task while polling.
- After success, read data.results.items and pass next_cursor back to the task route while has_more is true.
curl -X POST "https://api.socq.ai/v1/google-play/app-reviews" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://play.google.com/store/apps/details?id=com.example.notes"],"country":"US","results_limit":100}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueBest Use Cases
- Feedback theme research: Use review text and ratings to prepare a source-linked corpus for qualitative coding or downstream text analysis.
- Rating and text comparison: Compare written feedback with the associated numeric rating across selected public app pages.
- Review timeline monitoring: Combine publication and collection times to compare separately collected review samples around product releases.
- App-linked dataset enrichment: Attach reviewer, text, rating, and timestamp fields to app records using subject_id and subject_url.
Pro Tips
- Use complete public app URLs on play.google.com; other hosts fail input validation before collection begins.
- When submitting multiple URLs, choose results_limit as a task-wide target because the source allocation is divided across the app inputs and final storage is capped globally.
- Set country only when market context matters, and keep the same value across repeat collections that you intend to compare.
- Follow the task response's next_cursor for additional stored records; it is a SocQ result cursor, not a cursor accepted by the review source.
- Treat optional reviewer, source-link, and media fields as nullable instead of replacing missing values with invented defaults.
Related APIs
Use these APIs when you need a different type of public Google Play data.
- Google Play App Detail API — Retrieve normalized public Google Play listing details from known app URLs, including identity, store copy, developer, category, visible metrics, price, media, and collection context.
- Google Play App Rankings API