google-play/
app-reviews

The Google Play App Reviews API collects public Google Play app reviews from play.google.com app URLs with optional country context, returning review text, authors, ratings, timestamps, and app references as normalized records.

Google Play App Reviews API

App URL batches
Review text and ratings
Country context
0.15 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

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.

Google Play App Reviews API Features

  • Multi-app URL inputThe Google Play App Reviews API accepts one or more play.google.com app URLs and allocates 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.

Google Play App Reviews API Parameters

ParametersRequiredDescription
urlsRequiredRequired array of one or more non-empty app URLs on play.google.com or its subdomains.
countryOptionalOptional string passed to the review source as country context; omit it when no market context is required.
results_limitOptionalOptional positive integer from 1 through 2,000. It defaults to 100 and caps total stored results across all submitted URLs.

How to Use the Google Play App Reviews API

Submit Google Play app URLs to the Google Play App Reviews API, track the asynchronous task, and page through the normalized records stored by SocQ.

  1. Prepare one or more public app URLs whose hostname is play.google.com or one of its subdomains.
  2. POST urls with an optional country and results_limit to /v1/google-play/app-reviews, then save the returned task_id.
  3. Poll /v1/tasks/{task_id} until the task succeeds or fails; do not submit another task while polling.
  4. 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 true

Google Play App Reviews API Use Cases

  • Feedback theme research: Use the review text and ratings from the Google Play App Reviews API 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.

Google Play App Reviews API 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.

Beyond the Google Play App Reviews API, use these APIs when you need a different type of public Google Play data.

Explore other platforms

Combine Google Play data with public data from other supported social platforms.

Google Play App Reviews API — FAQ

Google Play App Reviews API is a programmatic interface for collecting public app reviews from one or more submitted Google Play app URLs with optional country context. It returns normalized review text, reviewer details, ratings, publication times, media, and reviewed-app references.

urls is a required array of non-empty URLs whose hostname is play.google.com or a subdomain. country is an optional string forwarded to the source request and can be omitted.

results_limit defaults to 100 and accepts integers from 1 through 2,000. The source request distributes the requested count across submitted URLs, while SocQ caps the task's total stored results at the requested limit.

A normalized record can contain review ID, source URL, text, reviewer identity, numeric rating, publication and collection times, app identifier, app URL, and media references. Optional fields remain null or empty when the public result does not provide them.

No caller-supplied source cursor is accepted. After the asynchronous task succeeds, next_cursor and has_more page through result rows already stored by SocQ.

The task is estimated at 100 results when results_limit is omitted and costs 0.15 SocQ credits per stored result. Final billing uses the actual result count, and a successful empty result settles to the zero-credit base charge.