Skip to main content

​
Composite Trends

Returns the composite score time series, which aggregates all trend baskets into a single weekly indicator. This is the top-level metric used in briefing headlines and classification logic.

​
Endpoint

GET /api/trends/composite

​
Authentication

Requires a valid JWT passed via the Authorization header.

​
Query Parameters

​
geography
string
required
ISO 3166-1 alpha-2 country code (e.g. US, UK).

​
Response

​
composite
array
Array of weekly composite observations ordered by week_start ascending.
​
count
number
Number of observations returned.
​
lastUpdated
string
ISO 8601 timestamp of the most recent data refresh.

​
Code Examples

curl -X GET "https://api.consumersignals.io/api/trends/composite?geography=US" \
  -H "Authorization: Bearer <token>"

​
Example Response

{
  "composite": [
    { "week_start": "2026-03-16", "composite_score": 51.2 },
    { "week_start": "2026-03-23", "composite_score": 48.7 },
    { "week_start": "2026-03-30", "composite_score": 54.0 }
  ],
  "count": 3,
  "lastUpdated": "2026-03-31T04:00:00Z"
}