GET/v1/tacsi/history

TACSI Weekly Archive

Returns the full weekly archive for one entitled sector, newest first, capped at 260 rows per call and paged with the "before" cursor: pass the returned nextBefore value to walk further back in time. Full Database subscribers may also request sector=headline for the all-consumer composite archive. Same aggregate-only privacy model as the weekly feed: k-anonymized cohorts of at least 50 distinct entities, differential privacy at publication, banded cohort sizes only, and no individual account data.

Bearer token required. A Sector Feed for the sector, or a Full Database subscription (required for sector=headline).

Query Parameters

ParameterTypeRequiredDescription
sectorstring (slug)RequiredThe sector slug, or "headline" for the all-consumer composite (Full Database only).
fromstring (YYYY-MM-DD)OptionalInclusive earliest week end to return.
tostring (YYYY-MM-DD)OptionalInclusive latest week end to return.
beforestring (YYYY-MM-DD)OptionalPagination cursor: return weeks strictly before this date. Use the nextBefore value from the prior page.
Request
curl -X GET "https://api.amilere.com/v1/tacsi/history?sector=beverages&from=2026-01-01&to=2026-07-12" \
  -H "Authorization: Bearer prism_YOUR_API_KEY"
Response (200 OK)
{
  "sector": "beverages",
  "from": "2026-01-01",
  "to": "2026-07-12",
  "count": 27,
  "pageMax": 260,
  "hasMore": false,
  "nextBefore": null,
  "rows": [
    { "periodEnd": "2026-07-12", "indexValue": 104.7, "delta": 0.8, "pillars": { "impact": 102.1, "momentum": 106.4, "presence": 103.0, "reach": 101.5, "sentiment": 105.2 }, "cohortBand": "n >= 100", "methodologyVersion": "TACSI_M1" }
  ]
}

Error Codes

401

Unauthorized

Missing, malformed, expired, or revoked API key.

403

Not Licensed

This feed is not licensed for your organization. Contact sales. Uniform for an unknown or unlicensed sector, a headline request without Full Database, or an exclusivity lockout.

429

Rate Limited

Per-key rate limit exceeded. Honour the Retry-After header.