post
https://production-api.shoutaboutus.com/api/v1/account/insight-report/latest
Returns the most recent stored insight report for a target identity (store + review site + period + theme), read entirely from our database — it never calls ReviewData and never consumes usage. When no matching report exists, data.found is false, signalling the UI to offer a Generate action.
Auth: Both — authentication; store_id scoped by an ownership check (auth-company-tree walk). A Partner reaches any store in its sub-tree; an Account only its own stores. The match also keys on review_site_id (null vs specific), year, month (null = full-year), and theme, returning the latest (id) match.
Rate limit: No rate limit.
Request
- Body (all top-level, JSON):
| Field | Type | Required | Notes |
|---|---|---|---|
store_id | integer | yes | Must be an existing location inside your own account tree. |
review_site_id | integer | no | Must be an existing review site and must be linked to the store; omit to match the all-publisher report (matched as review_site_id IS NULL). |
year | integer | yes | between:2000,2100. |
month | integer | no | between:1,12. Omit to match the full-year report. |
theme | string | yes | max:64. |
Response — { data. } envelope, HTTP 200.
- When no report exists:
{ "found": false }only. - When found:
found(boolean,true) plus the fullpresentpayload:insight_report_id(integer),store_id(integer),review_site_id(integer|null),publisher(string),year(integer),month(integer|null),theme(string),status(string),task_id(string|null),review_count(integer|null),result_summary(object|null),failure_reason(string|null),failure_details(object|null),completed_at(string|null, ISO-8601).
Errors: 422 on validation failure.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
