Review-response reports
Review-response feed, KPI cards, by-location / by-site breakdowns, Excel + PDF exports, ranking-report payload.
Review-response feed, KPI cards, by-location / by-site breakdowns, Excel + PDF exports, ranking-report payload.
Prerequisites
- A bearer token in the
Authorizationheader. Any endpoint that needs no token says so on its own page. - The id of each record the call targets. Every endpoint page lists the ids it needs.
Errors
| Status | Meaning |
|---|---|
401 | The bearer token is missing, expired or invalid |
403 | The token is valid but the record sits outside your account |
422 | The request failed validation — the response names the fields |
500 | Unexpected server error |
Individual endpoints may return more; each page lists its own.
Endpoints
POST — Returns a paginated review-response feed across the partner's whole company tree, plus an overall average rating and a per-publisher KPI tile strip (hipages tile unifies reviews across all connected sites; all others use a simple AVG of rated rows).
POST — Returns period-over-period KPI cards (review counts, ratings, response rate, average response time, awaiting-response, sentiment split) for the account-scoped response report.
POST — Returns a paginated per-location (per-store) response table for the authenticated account — reviews, responses, average response time, average rating, response rate.
POST — Returns review/response metrics grouped by review site (publisher) for the authenticated account — per-site review count, average rating, % of total, response count, response rate.
POST — Ranks the authenticated account's locations against each other over a date range — by review volume, average rating, and response rate — and computes a blended overall rank with a letter grade.
POST — Generate a review-response feed Excel workbook for the caller's stores over a date range, stores it on the S3 disk, and returns the public download URL.
POST — Returns the full performance-report dataset for a PDF: header/company block, KPIs (with previous-period comparisons), sentiment split, per-site and per-location review/response breakdowns, and the review-response feed.
POST — Account-friendly alias of the review-response feed (Review-response feed) — same controller method, mounted under reports/response so an account user reading their own reviews and a partner-admin reading across accounts both work.
POST — Returns per-publisher lifetime totals (all-time count + overall rating from the synced pivot, hipages spans all connected sites) plus the selected-period review count and rating, scoped to the authenticated account.
GET — Get total review count plus a per-star breakdown for a single store, plus a canonical average rating and an off-platform review count.
Updated 9 days ago