APIReferenceBrands

Per-category windowed score deltas

Windowed hero delta (same shape as the score-history endpoints) for every non-archived category on the brand, over the same window — so category-card delta chips agree with the brand chart for that window.

GET/api/brands/{brand_id}/category-deltas/

Authorization

AuthorizationBearer <token>

Personal Access Token (create one from Settings -> API Keys in the dashboard). Send as Authorization: Bearer gr_live_.... An X-API-Key: gr_live_... header (see the apiKeyAuth scheme) is accepted as an equivalent alternative — send ONE of the two, not both.

In: header

Path Parameters

brand_id*integer

Query Parameters

since?string

ISO date/datetime cutoff for the display window, or all for the full history. Omit for the default 30-day window. The running score accumulation always spans all history — since only bounds which points are returned.

Response Body

application/json

curl -X GET "https://example.com/api/brands/0/category-deltas/"
{  "deltas": {    "412": {      "latestScore": 701,      "boundaryScore": 664,      "delta": 37,      "asOfRunId": 9931,      "spanLabel": "last 30 days",      "suppressedReason": null    },    "413": {      "latestScore": 588,      "boundaryScore": null,      "delta": null,      "asOfRunId": 9931,      "spanLabel": "last 30 days",      "suppressedReason": "no_boundary"    }  }}