Updated on 2026-05-12 NovaDataHub Engineering

Developer docs

Play Store Reviews API Documentation

The Play Store Reviews API returns structured review records with rating, review text, author metadata, app version context, helpful votes, and developer replies for recurring feedback workflows.

Key points

Supports appId, count, language, country, and sort parameters.
Structured review JSON works well for QA, sentiment, and competitor research workflows.
The same authentication pattern works as the rest of the NovaDataHub API surface.

Common errors

400 appId is required
401 invalid_key
429 rate_limited
500 data_source_failed

Reference details

Parameters, response shape, and operational notes

Parameter notes

appId is the required package name parameter.
count controls review volume per request and should match how much downstream processing you want to do.
sort is useful for switching between freshest review monitoring and higher-signal review analysis.

Response highlights

Look for reviews[].rating, reviews[].text, reviews[].version, reviews[].date, and reviews[].reply.
Version and date context are especially useful when mapping feedback to releases.
Reply and helpful-vote fields are useful for support and prioritization workflows.

Operational notes

Store both raw review text and selected normalized fields if you plan to run recurring analysis.
Group records by version and collection time when you are monitoring releases.
Treat review ingestion as a repeatable pipeline instead of a one-off export so trends become visible.

Implementation checklist

Start with one appId and newest sorting to validate payload shape.
Decide whether the first workflow is release QA, sentiment analysis, or competitor monitoring so storage stays focused.
Add simple tagging or classification after the collection pipeline is stable.

Code examples

Visible integration examples

curl

curl -s -H "x-api-key: YOUR_API_KEY" "https://novadatahub.com/api/playstore/reviews?appId=com.spotify.music&count=50&sort=newest"

Python

import requests
url = 'https://novadatahub.com/api/playstore/reviews'
params = {'appId': 'com.spotify.music', 'count': 50, 'sort': 'newest'}
resp = requests.get(url, params=params, headers={'x-api-key': 'YOUR_API_KEY'}, timeout=60)
print(resp.json())

C# HttpClient

using System.Net.Http.Json;
using System.Text.Json;
using var http = new HttpClient();
http.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");
var json = await http.GetFromJsonAsync<JsonElement>("https://novadatahub.com/api/playstore/reviews?appId=com.spotify.music&count=50&sort=newest");
Console.WriteLine(json.ToString());

Sample JSON response

{
  "ok": true,
  "appId": "com.spotify.music",
  "reviews": [
    {
      "rating": 5,
      "author": "Alice",
      "text": "Love the new UI!",
      "version": "8.9.0",
      "date": "2026-05-10"
    }
  ]
}

Related resources

Move from reference docs into the next relevant workflow

Play Store Reviews API landing page

Open the commercial overview page for ratings, review text, versions, and developer replies.

Open landing page

Play Store review fields

Map review rating, text, version, date, replies, and collection context into cleaner downstream models.

Open docs

Review monitoring tutorial

See how to group reviews by version, surface complaint spikes, and support release QA workflows.

Open tutorial

API playground workflow

Validate review request parameters and inspect JSON before wiring release-monitoring or sentiment pipelines.