Skip to content

gplay reviews list

List the user reviews the Google Play API exposes for --package.

The API only returns reviews from the LAST 7 DAYS; a WARN line to that effect is always printed to stderr (long-history retrieval via GCS CSV reports is on the backlog). Results are auto-paginated until exhausted.

--stars filters client-side and accepts a single rating (1), an inclusive range (1-2), or a set (1,3,5); each rating must be 1..5. --limit N caps the final count after filtering (0 = no cap).

Default table columns: date, stars, locale, reviewId, summary. Override with --columns stars,reviewId,... (--output json is the {"reviews":[...]} pass-through reflecting the filtered set; --output markdown renders a Markdown table.)

gplay reviews list [flags]
FlagDescription
--columns stringcomma-separated table columns to show (default: date,stars,locale,reviewId,summary)
--limit intcap the result count after filtering (0 = no cap)
--output stringoutput format: table, json, or markdown (default: auto — table on TTY, json in pipes/CI)
--package stringAndroid package name (overrides .gplay/config.json pin)
--stars stringclient-side star filter: 1, 1-2, or 1,3,5 (each rating 1..5)
FlagDescription
--account stringname of a stored Account to use (overrides env and active Account)
--retry intretry transient failures (transport errors, 5xx, 429) up to N times with exponential backoff (default: 0, no retry)
--service-account stringpath to a service-account JSON, or inline JSON content (overrides --account, env, and active Account)
--timeout durationper-request API timeout, e.g. 30s or 2m (default: 60s for control-plane calls, none for uploads)
-v, --verboselog flow steps to stderr (info level)