Skip to main content
GET
/
api
/
narrative
Weekly Narrative
curl --request GET \
  --url https://api.example.com/api/narrative
{
  "weekStart": "<string>",
  "headline": "<string>",
  "classification": "<string>",
  "score": 123,
  "sections": {
    "cpixUpdate": "<string>",
    "keySignals": "<string>",
    "behaviouralShifts": "<string>",
    "sectorImplications": "<string>",
    "watchlist": "<string>"
  },
  "generatedAt": "<string>"
}
Returns the latest weekly narrative report, including a headline summary, CPIx classification, and structured editorial sections covering the score update, key signals, behavioural shifts, sector implications, and items to watch.

​
Authentication

Requires a valid JWT token in the Authorization header. 
Authorization: Bearer <token>

​
Query Parameters

​
geography
string
default:"US"
Target geography. Supported values: US, UK.

​
Response

​
weekStart
string
Start date of the reporting week in YYYY-MM-DD format.
​
headline
string
One-line editorial headline summarising the week.
​
classification
string
Current regime classification: stable, rising_pressure, or elevated_stress.
​
score
number
CPIx composite score for the week on a 0—100 scale.
​
sections
object
Structured editorial content.
​
generatedAt
string
ISO 8601 timestamp when the narrative was generated.

​
Examples

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

​
Example Response

{
  "weekStart": "2026-03-23",
  "headline": "Energy costs push CPIx higher as housing pressures stabilise",
  "classification": "rising_pressure",
  "score": 62.4,
  "sections": {
    "cpixUpdate": "The CPIx composite score rose 1.8 points to 62.4, moving further into rising_pressure territory. The increase was driven primarily by energy-related drivers, with gasoline prices tracking above seasonal norms for the third consecutive week.",
    "keySignals": "Three high-severity signals fired this week, all concentrated in the energy and transport categories. The gasoline divergence signal has now been active for three consecutive periods, increasing its credibility weighting.",
    "behaviouralShifts": "Consumer search patterns indicate increased price sensitivity in discretionary categories. Grocery substitution behaviour is trending upward, suggesting households are actively managing budgets.",
    "sectorImplications": "Consumer Discretionary faces the most concentrated risk from current dynamics. Transport and logistics operators may see margin compression if fuel costs persist at current levels.",
    "watchlist": "Monitor weekly energy market data for signs of refinery margin normalisation. The upcoming CPI release will be critical for confirming or contradicting the current signal cluster."
  },
  "generatedAt": "2026-03-29T06:00:00Z"
}