Skip to main content

​
Sector Overview

Returns a comprehensive consumer-signal view for a given sector, including the pressure score, directional trend, active signals, relevant trend baskets, composite signal data, data freshness metadata, and company-level exposure.

​
Endpoint

GET /api/sectors/:sectorId

​
Authentication

Requires a valid JWT passed via the Authorization header.

​
Path Parameters

​
sectorId
string
required
Sector identifier. Valid values: travel, grocery, retail, apparel, restaurants, home_goods.

​
Query Parameters

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

​
Response

​
sectorId
string
The sector queried.
​
geography
string
Geography code.
​
pressureScore
number
Consumer-signal pressure score for the sector (0–100). Higher values indicate greater consumer stress.
​
trend
string
Directional trend of the pressure score (e.g. improving, stable, deteriorating).
​
activeSignals
array
List of currently active signal flags for this sector.
​
trendBaskets
array
Relevant trend baskets and their current scores within this sector context.
​
compositeSignals
object
Composite signal data specific to the sector.
​
dataFreshness
object
Metadata about the freshness of underlying data sources.
​
companyExposure
array
Companies within the sector and their exposure levels.

​
Code Examples

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

​
Example Response

{
  "sectorId": "retail",
  "geography": "US",
  "pressureScore": 64,
  "trend": "stable",
  "activeSignals": ["discount_seeking_elevated", "trade_down_moderate"],
  "trendBaskets": [
    { "basket": "discount_seeking", "score": 72.4, "momentum": -3.2 },
    { "basket": "trade_down", "score": 61.8, "momentum": 1.1 }
  ],
  "compositeSignals": {
    "composite_score": 54.0,
    "week_start": "2026-03-30"
  },
  "dataFreshness": {
    "trendsAsOf": "2026-03-31T04:00:00Z",
    "briefingAsOf": "2026-03-31T06:00:00Z"
  },
  "companyExposure": [
    {
      "ticker": "DG",
      "name": "Dollar General",
      "exposureLevel": "high",
      "rationale": "Core demographic highly sensitive to trade-down and credit stress signals."
    },
    {
      "ticker": "WMT",
      "name": "Walmart",
      "exposureLevel": "low",
      "rationale": "Beneficiary of trade-down behaviour; defensive positioning."
    }
  ]
}