Skip to main content

​
Regional Trends

Returns trend data disaggregated by sub-national region, enabling analysts to identify geographic divergence in consumer behaviour. Regions correspond to standard statistical areas (e.g. Census divisions for the US, NUTS-1 regions for the UK).

​
Endpoint

GET /api/trends/regional

​
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

The response contains a regional breakdown of trend baskets, allowing comparison of signal intensity across sub-national regions within the requested geography.
​
geography
string
The geography queried.
​
regions
array
Array of regional trend observations.
​
lastUpdated
string
ISO 8601 timestamp of the most recent data refresh.

​
Code Examples

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

​
Example Response

{
  "geography": "US",
  "regions": [
    {
      "region": "south",
      "baskets": [
        { "basket": "discount_seeking", "score": 78.2, "smoothed": 74.1, "momentum": -2.1 },
        { "basket": "trade_down", "score": 65.0, "smoothed": 64.3, "momentum": 0.8 }
      ]
    },
    {
      "region": "northeast",
      "baskets": [
        { "basket": "discount_seeking", "score": 62.5, "smoothed": 61.0, "momentum": -1.4 },
        { "basket": "trade_down", "score": 55.3, "smoothed": 56.1, "momentum": -0.3 }
      ]
    }
  ],
  "lastUpdated": "2026-03-31T04:00:00Z"
}