Compare a location's reviews against one or two competitors on the same review site.
Compare a location's reviews against one or two competitors on the same review site.
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 | Generate a competitive report | Queue an async competitive report comparing one store location against 1-2 competitors on one shared publisher (review site). |
POST | Check report status | Polls the current status of a previously-queued competitive report, read straight from our database (the completed report lands via the COMPETITIVE_REPORT_RESULT webhook). |
POST | List past reports | List every competitive report stored for one store location, newest first (paginated), so the account can re-open a past report (use each row's competitive_report_id with Check status (poll until complete) to fetch the full payload). |
POST | List comparison themes | Returns the live competitive-report theme list (slug + label + KPIs) for the store's partner, falling back to the shipped defaults (home-services / food-dining) when the report service is unreachable or the partner is not configured for it. |