Foresight API
Ask one API for the economy. Jobs, prices, housing, government budgets — the numbers people actually argue about, served as clean, citable time series from the national level down to a single county. Creative Foresight’s own derived series sit alongside the public data and tell you when something starts moving.
Two ways in, both self-serve: one request gets you a free key, or your agent can pay per call — USDC (x402) or Lightning (L402) — and skip accounts entirely.
Point your agent at it
Using Claude, ChatGPT, Cursor, or any agent with web access? Paste this and you’re onboarded:
Read https://api.creativeforesight.io/llms-full.txt, then walk me
through my two ways in — a free API key or paying per call (x402 or L402) —
and set up whichever fits how I'll use it.Why use it?
Economic data is scattered across providers, each with its own identifiers, region model, release cadence, and revision semantics. Foresight API normalizes those differences into a small set of resources: sources, indicators, regions, observations, and computed insights.
Creative Foresight also publishes derived cf:* indicators. These combine source data into opinionated signals with explicit provenance, so agents can cite both the derived series and the underlying public indicators.
Start here
Quickstart
Get a key, make the first observations request, or connect through MCP and per-request payment.
Concepts
Understand indicators, observations, regions, revisions, and the cf:* derived layer.
API Reference
Endpoint-by-endpoint request and response details for the v1 read API.
Pricing and Limits
Plan limits, per-request pricing, rate-limit headers, and standard error codes.
API basics
| Item | Value |
|---|---|
| Base URL | https://api.creativeforesight.io |
| OpenAPI Spec | /openapi.json |
| Short agent file | /llms.txt |
| Full agent file | /llms-full.txt |
| API key headers | Authorization: Bearer cf_live_... or X-API-Key: cf_live_... |
Surface map
Catalog routes help applications discover what is available. Observation routes return the values, periods, revision state, and source-update timestamps that production systems usually need. Insight routes add deterministic descriptive facts, such as trend, latest delta, watermarks, and longest runs.