Latest Briefing Returns the current week’s consumer-signals briefing, including headline classification, sectoral signals, company exposure, and forward-looking dates.
Endpoint Authentication Requires a valid JWT passed via the Authorization header.
Query Parameters ISO 3166-1 alpha-2 country code (e.g. US, UK).
Response ISO 8601 date for the briefing week (Monday).
One-line editorial headline summarising the week’s consumer signal environment.
Signal classification label (e.g. moderate_deterioration, stabilisation).
Composite consumer-signal score for the week (0–100).
Structured narrative sections of the briefing. High-level summary paragraph.
Historical context and comparisons.
Market and portfolio implications.
Contrarian or counter-consensus observations.
Company-level exposure narrative.
Names and themes to monitor.
Upcoming macro and earnings dates narrative.
Categorised company exposure lists. Show companyExposure fields
Tickers with elevated consumer-signal risk.
Tickers exhibiting defensive characteristics.
Forward calendar of macro and earnings events. Why this event matters for consumer signals.
Either macro or earnings.
Whether the date is confirmed by the source.
ISO 8601 timestamp of briefing generation.
Generation method. One of ai, rule-based, or ai+search.
Cross-signal synthesis metadata. Show signalSynthesis fields
Whether signals are converging or diverging.
Forward-looking synthesis statement.
Probability-weighted outlook scenarios. Show consumerOutlook fields
Probability of stabilisation scenario.
Probability of moderate deterioration.
Probability of sharp deterioration.
Outlook time horizon (e.g. 4w, 8w).
Directional momentum for individual signal baskets. One of accelerating, easing, or stable.
Code Examples curl -X GET "https://api.consumersignals.io/api/briefing/latest?geography=US" \ -H "Authorization: Bearer <token>"
Example Response { "weekStart" : "2026-03-30" , "headline" : "Discount-seeking intensity eases as spring demand normalises" , "classification" : "stabilisation" , "score" : 54 , "sections" : { "summary" : "Consumer signals showed modest improvement this week..." , "keySignals" : "Discount-seeking search volume declined 6% w/w..." , "historicalContext" : "Current composite sits 2pts above the 52-week average..." , "implications" : "Stabilisation supports near-term discretionary exposure..." , "contrarianFlags" : "Credit-card delinquency data lags by 4 weeks..." , "companyExposure" : "TGT and DG remain most exposed to trade-down..." , "watchlist" : "Monitor WMT earnings on 2026-04-10..." , "keyDates" : "FOMC minutes on 2026-04-09; CPI print on 2026-04-11..." }, "companyExposure" : { "highRisk" : [ "DG" , "BBWI" , "KSS" ], "defensive" : [ "WMT" , "COST" , "PG" ] }, "keyDates" : [ { "date" : "2026-04-09" , "event" : "FOMC Minutes Release" , "relevance" : "Rate-path signal for consumer credit costs" , "type" : "macro" , "confirmed" : true } ], "generatedAt" : "2026-03-31T06:00:00Z" , "narrativeSource" : "ai+search" , "signalSynthesis" : { "note" : "Search and sentiment signals are converging on stabilisation." , "convergenceFlag" : "converging" , "forwardLook" : "Expect range-bound composite over the next 2 weeks." }, "consumerOutlook" : { "stabilisation" : 0.55 , "moderateDeterioration" : 0.35 , "sharpDeterioration" : 0.10 , "horizon" : "4w" }, "signalMomentum" : [ { "label" : "discount_seeking" , "direction" : "easing" }, { "label" : "trade_down" , "direction" : "stable" } ] }
