Get total-review chart

Overview

Total-reviews line chart for the account dashboard: a cumulative (running) count of reviews per time bucket across the window. Bucket granularity is auto-selected from the range span — daily (≤30d), weekly (≤180d), monthly (≤730d), else yearly — with the timeline gap-filled so each bucket is present.

Prerequisites

• A bearer token. Callable with Account tokens.

Base URL

Endpoint

GET /api/v1/account/dashboard/get-totalreview-chart

Authentication

• Requires a bearer token in the Authorization: Bearer <bearer-token> header.

• Who can call it: Account tokens.

• Mounted under the account/dashboard group (role-agnostic).

• Scope is the caller's company tree.

• store_id (if given) is validated by an ownership check; otherwise all of the caller's stores are used.

Rate limit

• No rate limit.

Query parameters

• Query: store_id (integer, optional) — must belong to the caller's company; omit it to cover all of your locations.
• Query: review_site_id (integer, optional) — filter to one platform; must be an existing review site. When omitted, the caller company's industry review sites apply.
• Query: range_start (string Y-m-d, optional) — defaults to start of 13 months ago.
• Query: range_end (string Y-m-d, optional) — must be ≥ range_start; defaults to end of current month.

Response

• period (string) — bucket key (monthly 2025-05, daily 2025-05-01, weekly 2025-19, yearly 2025).
• count (integer) — cumulative review count up to and including this bucket.

200 Success · 200

{
  "data": [
    { "period": "2026-03", "count": 312 },
    { "period": "2026-04", "count": 401 },
    { "period": "2026-05", "count": 535 }
  ]
}

Errors

Example request

curl --request GET \
  --url "https://production-api.shoutaboutus.com/api/v1/account/dashboard/get-totalreview-chart?store_id=123&review_site_id=123&range_start=2026-01-01&range_end=2026-01-31" \
  --header 'Authorization: Bearer <bearer-token>' \
  --header 'Accept: application/json'