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
| Method | Endpoint | Description |
|---|---|---|
POST | Review-response feed | 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 uses the bridge formula; all others use a simple AVG of rated rows). |
POST | Response report — KPIs | 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 | Response report — by location | Returns a paginated per-location (per-store) response table for the authenticated account — reviews, responses, average response time, average rating, response rate. |
POST | Response report — by site | 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 | Ranking report (full payload) | 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 | Excel — review-response feed | 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 | PDF — performance report | 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 | Review-response feed (account-friendly route alias) | 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 | Reviews by publisher (account-scoped) | Returns per-publisher lifetime totals (all-time count + overall rating from the synced pivot, hipages via bridge) plus the selected-period review count and rating, scoped to the authenticated account. |
GET | Reviews stats (star breakdown) | Get total review count plus a per-star breakdown for a single store, plus a canonical average rating and an off-platform review count. |