---
title: "Get review stats"
description: "Returns stats on reviews your keywords collect from the App Store, Google Play, Trustpilot and Google Maps. You get the count, average stars, the star distribution, replies and open 1 and 2 star reviews, for the workspace and per review page. Each page has a series of average stars per `bucket`, and the report lists the tags of unhappy reviews. Two keywords matching one review count it once. Pick the period with `range` (7d, 30d, 90d or 365d up to today) or with `from` and `to`. Days follow `timezone`, UTC by default. `keywordIds` and `platforms` narrow the data, and `compare=true` adds the equally long period just before. Dates are publish dates."
canonical: https://docs.rumoro.dev/api/analytics/get-reviews-report
markdown: https://docs.rumoro.dev/api/analytics/get-reviews-report.mdx
---

# Get review stats

`GET /v1/analytics/reviews`

Returns stats on reviews your keywords collect from the App Store, Google Play, Trustpilot and Google Maps. You get the count, average stars, the star distribution, replies and open 1 and 2 star reviews, for the workspace and per review page. Each page has a series of average stars per `bucket`, and the report lists the tags of unhappy reviews. Two keywords matching one review count it once. Pick the period with `range` (7d, 30d, 90d or 365d up to today) or with `from` and `to`. Days follow `timezone`, UTC by default. `keywordIds` and `platforms` narrow the data, and `compare=true` adds the equally long period just before. Dates are publish dates.

## Parameters

| Name | In | Description |
| --- | --- | --- |
| `range` | query | A preset period up to today, 30d by default. Ignored when you send from or to. |
| `from` | query | Start date in `timezone`, as YYYY-MM-DD. That day is included. |
| `to` | query | End date in `timezone`, as YYYY-MM-DD, included. Defaults to today. |
| `keywordIds` | query | Keeps these keyword ids only. Repeat the parameter or separate values with commas. Leave it out for all keywords. |
| `platforms` | query | Keeps these platforms only. Repeat the parameter or separate values with commas. Leave it out for all platforms. |
| `compare` | query | true adds the equally long period just before as `previous`. |
| `timezone` | query | The IANA time zone used to split days, such as America/New_York. Defaults to UTC. The zone's offset at the end of the period is used for the whole period. |
| `bucket` | query | The step of each series, day or week. Days by default for periods up to 90 days. |

## Responses

| Status | Meaning |
| --- | --- |
| 200 | The report, plus `previous` with compare=true |
| 400 | The query is not valid |
| 401 | The API key is missing or not valid |

The [OpenAPI document](https://api.rumoro.dev/v1/openapi.json) has every schema. Rules shared by all endpoints are in [Conventions](https://docs.rumoro.dev/conventions.mdx).