Loading data…
Build inflation dashboards, embed prices in articles, or pipe the Basket Index into your own products. Every endpoint is free during preview. Paid tiers (Starter, Pro, Enterprise) will unlock higher rate limits, historical bulk downloads, and SLA.
https://basketindex.org/api/public
Not required today. When paid tiers launch, include an API key as a Bearer token.
curl -H "Authorization: Bearer YOUR_KEY" \
https://basketindex.org/api/public/eggs| Tier | Limit | Historical depth | Future price |
|---|---|---|---|
| Anonymous | 60 / minute | Last 5 years | Free |
| Starter | 300 / minute | Last 10 years | $29/mo |
| Pro | 1,000 / minute | Full history | $199/mo |
| Enterprise | Custom | Full history + bulk | Contact us |
Every response carries X-RateLimit-Limit and X-API-Tier headers today so your monitoring is ready before billing turns on.
/api/public/basket-indexThe flagship Basket Index™ series for a (region, household) pair.
https://basketindex.org/api/public/basket-index?region=US&household=family-of-4
{
"meta": { "version": "v1", "attribution": "Basket Index" },
"data": {
"region": { "code": "US", "name": "United States" },
"household": { "slug": "family-of-4", "name": "Family of 4" },
"base": { "year": 2020, "month": 1, "value": 100 },
"points": [
{ "date": "2020-01-01", "index": 100.0, "basketCostUsd": 1834.12 },
...
],
"summary": {
"current": 132.4,
"oneMonthChangePct": 0.3,
"twelveMonthChangePct": 4.2
}
}
}/api/public/itemsList every tracked item plus its canonical upstream series id.
https://basketindex.org/api/public/items
/api/public/{slug}Latest monthly observations + summary metrics for a single item.
https://basketindex.org/api/public/gasoline?region=TX&months=24
{
"meta": { ... },
"data": {
"item": { "slug": "gasoline", "unit": "gallon", "source": "EIA", ... },
"region": { "code": "TX", "name": "Texas" },
"observations": [
{ "date": "2024-05-01", "value": 2.94, "source": "EIA" },
...
],
"summary": {
"current": 3.18,
"oneMonthChangePct": 0.4,
"twelveMonthChangePct": -3.1,
"historicalHigh": { "value": 4.91, "date": "2022-06-01" },
"historicalLow": { "value": 1.81, "date": "2020-05-01" }
}
}
}Underlying data is in the public domain (US federal works). Basket Index™ adds ingest, normalization, regional derivation, and the proprietary index formula — these are licensed for non-commercial use during preview. For commercial use, please contact us about an Enterprise license.
Cite as: "Basket Index™, [date], basketindex.org/api/public/{slug}".