AI insight report

An AI-written report on what a business's reviews say: themes, praise, complaints, and suggestions.

An AI-written report on what a business's reviews say: themes, praise, complaints, and suggestions, generated on demand or monthly.

Generating a report takes a minute or two. Start it, poll for completion, then fetch it. Each report counts against your plan's insight-report allowance.

You'll need an account token and the store_id or account.

📘

Scheduled email reports are set up through separate endpoints: Schedule an account email report (daily, weekly or monthly, depending on the report), Schedule a partner email report, and List scheduled reports to manage them. To build reporting into your own product instead, use the KPI and report endpoints, such as Headline numbers.

Prerequisites

  • A bearer token in the Authorization header. 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

StatusMeaning
401The bearer token is missing, expired or invalid
403The token is valid but the record sits outside your account
422The request failed validation — the response names the fields
500Unexpected server error

Individual endpoints may return more; each page lists its own.

Endpoints

Generate an insight report

POST — Start generating a report for a location or account over a period.

Open →

Check report status

POST — See whether a report is still generating or ready.

Open →

Get the latest report

POST — Fetch the most recent completed report for a location or account.

Open →

Generate last month's report

POST — Generate a report covering the previous calendar month.

Open →

Regenerate a report

POST — Discard a report and generate it again.

Open →

AI insights summary

GET — A quick AI-written summary of themes, praise, and complaints, scoped to the account.

Open →


Did this page help you?