API & data access

Public JSON, export links, source discovery, and boundaries for analysts and lightweight integrations.

Pick a surface

  1. 1

    Tracked slug

    Stable public JSON for one curated indicator.

  2. 2

    Connected source

    Provider search when the curated library is too narrow.

  3. 3

    Export or health

    Files, uptime checks, and integration probes.

Three public data surfaces

Start with the narrowest route that answers the question. Move wider only when the job needs it.

Tracked core API

Stable public JSON for the curated indicators that power the site.

Tracked slugsPublic JSON
Open tracked example

Connected-source discovery

Wider search for World Bank, IMF, or provider-native series when the tracked library is too narrow.

World BankIMF
Open global discovery

Downloads and monitoring

Exports and health checks for integration, monitoring, or recurring pull-based workflows.

CSVHealth
Open health route

Endpoint families

Public routes are organized by job: tracked indicators, connected-source research, or monitoring.

Tracked indicator endpoints

Slug-based routes for page metadata, chart history, release framing, or paid downloads for one public series.

GET /api/indicators/libraryGET /api/indicators/library?scope=globalGET /api/indicators/library?scope=global&starter=trueGET /api/indicators/:slugGET /api/indicators/:slug/observationsGET /api/indicators/:slug/downloadGET /api/indicators/:slug/download/json

Connected-source research endpoints

Search and preview endpoints for country or multilateral coverage beyond the tracked U.S. library.

GET /api/indicator-import/search?provider=worldbank&q=gdp%20growthGET /api/indicator-import/search?provider=imf&q=inflationGET /api/indicator-import/preview?provider=fred&seriesId=GDPC1

Timing, news, and monitoring

Release timing, macro-news joins, and uptime checks instead of one series history.

GET /api/calendar/releasesGET /api/newsGET /api/health

Quick starts

Pick the path that matches the data job before copying an endpoint.

Build against a tracked slug

Best when you already know the public series and want stable JSON for one core macro indicator.

GET /api/indicators/headline-cpi/observations
Open tracked indicator

Pull the tracked global catalog

Best when you want the curated non-U.S. slice without opening wider research routes.

GET /api/indicators/library?scope=global&starter=true
Open global catalog API

Search broader multilateral coverage

Best when the question is country-level or multilateral and the tracked U.S. library is not enough.

GET /api/indicator-import/search?provider=worldbank&q=India%20GDP%20growth
Open World Bank lane

Export or monitor

Best when you need a file download, forecast output, or a lightweight health endpoint for infra checks.

GET /api/health
Open monitoring route

Global discovery

Start with the narrowest route that answers the question. Move wider only when the job needs it.

Asia growth pack

India GDP growth

Latin America debt pack

Brazil debt to GDP

Europe inflation pack

Euro area inflation

Africa labor pack

South Africa unemployment

Usage rules

Public read-heavy routes are site-powered JSON endpoints, not a separate account-key developer product yet.

The indicator library route supports public filters such as scope, source, category, and slugs.

Connected-source search and preview routes are research surfaces, especially for attribution-bound providers.

Downloads and exports inherit source, attribution, and research-lane boundaries.

User-specific flows remain account surfaces, not public feeds.

Health route

Files, uptime checks, and integration probes.

GET /api/health