Skip to Content
GuidesOverview

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

API basics

ItemValue
Base URLhttps://api.creativeforesight.io
OpenAPI Spec/openapi.json
Short agent file/llms.txt
Full agent file/llms-full.txt
API key headersAuthorization: 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.

Last updated on