---
title: "Intelligence Consumer Demand"
method: GET
path: "/api/intelligence/v1/consumer-demand/{ticker}"
tags: ["Intelligence API"]
---

# Intelligence Consumer Demand

`GET /api/intelligence/v1/consumer-demand/{ticker}`

## Request

- Base URL: `https://api.xfinlab.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.xfinlab.com/api/intelligence/v1/consumer-demand/{ticker}`
- Auth: none declared

FRED US consumer-spending context for `ticker` (services/
consumer_demand_service.py -- retail sales, personal consumption
expenditures, durable goods consumption). NOT Google Trends search-
interest data -- see that module's docstring for why (no officially
licensed, commercial-use-safe search-trends API exists). Only
populated for tickers with a real consumer-spending linkage (large
retailers, e-commerce, consumer-discretionary ETFs -- see that
module's _TICKER_TO_NAME) -- any other ticker returns `data: null`,
never a fabricated reading for an unrelated symbol.

## Path parameters

- `ticker` string, required

## Headers

- `X-API-Key` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/xfinlab/apis/xfinlab-api.md) · [All operations](https://skmtc.dev/xfinlab/apis/xfinlab-api/llms.txt) · [OpenAPI document](https://skmtc.dev/xfinlab/apis/xfinlab-api/revisions/205f85614bc6?raw)