# DBnomics API
> Economic data from 90+ official providers as one API, powered by DBnomics. DBnomics aggregates the public statistics of the IMF, OECD, Eurostat, the European Central Bank, the World Bank, the BIS, the US Federal Reserve and Bureau of Labor Statistics, national statistics offices and dozens more — millions of time series — into a single, consistent interface. List the data providers; search datasets across every provider at once by keyword; read a dataset's details and its dimensions (the codes you combine to pick a series); and fetch a series with its full observations (period and value) plus the latest data point. The typical flow is search → dataset → series. Ideal for macroeconomic and financial dashboards, data-science and research pipelines, fintech and economics apps, and anyone who needs GDP, inflation, unemployment, interest-rate, trade or monetary series from authoritative sources. Data is free and open.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/dbnomics-api/..."
```

## Pricing
- **Free** (Free) — 600 calls/Mo, 2 req/s
- **Starter** ($7/Mo) — 24,000 calls/Mo, 6 req/s
- **Pro** ($20/Mo) — 100,000 calls/Mo, 15 req/s
- **Mega** ($56/Mo) — 400,000 calls/Mo, 40 req/s

## Endpoints

### Catalogue

#### `GET /v1/providers` — The data providers

**Parameters:**
- `query` (query, optional, string) — Filter by name, e.g. IMF

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/dbnomics-api/v1/providers"
```

**Response:**
```json
{
    "data": {
        "count": 93,
        "providers": [
            {
                "code": "ACOSS",
                "name": "Agence centrale des organismes de sécurité sociale",
                "region": "FRANCE",
                "website": "https://www.acoss.fr/home.html"
            },
            {
                "code": "AFDB",
                "name": "African Development Group",
                "region": "Africa",
                "website": "https://www.afdb.org/en/"
            },
            {
                "code": "AIH",
                "name": "Africa Information Highway",
                "region": "AFRICA",
                "website": "https://www.afdb.org/en/knowledge/statistics/africa-information-highway-aih"
            },
            {
                "code": "AMECO",
                "name": "Annual macro-economic database of the European Commission's Directorate General for Economic and Financial Affairs",
                "region": "EU",
                "website": "https://ec.europa.eu/info/business-economy-euro/indicators-statistics/economic-databases/macro-economic-database-ameco_en"
            },
            {
                "code": "Apple",
                "name": "Apple",
                "region": "World",
                "website": "https://covid19.apple.com/mobility"
            },
            {
                "code": "AQICN",
                "name": "The World Air Quality Index Project",
                "region": "World",
                "
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/search` — Search datasets across providers

**Parameters:**
- `query` (query, required, string) — Search text, e.g. inflation Example: `inflation`
- `provider` (query, optional, string) — Restrict to a provider, e.g. Eurostat
- `limit` (query, optional, string) — Max results (1-100)

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/dbnomics-api/v1/search?query=inflation"
```

**Response:**
```json
{
    "data": {
        "count": 20,
        "query": "inflation",
        "total": 223,
        "datasets": [
            {
                "name": "Economic statistics ROPI-adjusted for inflation - Regions (for 'Developer API')",
                "dataset": "DSD_REG_ECO_ROPI@DF_ECO_ROPI",
                "provider": "OECD",
                "description": "<p style=\"text-align: justify;\">This dataset provides indicators on real GDP, GVA and labour productivity measures in large regions (TL2) and small regions (TL3).&nbsp;Real values are deflation-adjust",
                "series_count": 61060,
                "provider_name": "Organisation for Economic Co-operation and Development"
            },
            {
                "name": "Economic statistics ROPI-adjusted for inflation - Regions (for 'Developer API')",
                "dataset": "DSD_REG_ECO@DF_ECO_ROPI",
                "provider": "OECD",
                "description": "<p style=\"text-align: justify;\">This dataset provides indicators on real GDP, GVA and labour productivity measures in large regions (TL2) and small regions (TL3).&nbsp;Real values are deflation-adjust",
                "series_count": 58050,
                "provider_name": "Organisation for Economic Co-operation and Development"
            },
            {
                "name": "Annual Energy Outlook 2023",
                "dataset": "AEO.2023",
                "provider": "EIA",
                "description": "The Annual Energy Outlook 
…(truncated, see openapi.json for full schema)
```

### Data

#### `GET /v1/dataset` — A dataset's details & dimensions

**Parameters:**
- `provider` (query, required, string) — Provider code, e.g. Eurostat Example: `Eurostat`
- `code` (query, required, string) — Dataset code, e.g. une_rt_m Example: `une_rt_m`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/dbnomics-api/v1/dataset?provider=Eurostat&code=une_rt_m"
```

**Response:**
```json
{
    "data": {
        "dataset": {
            "code": "une_rt_m",
            "name": "Unemployment by sex and age - monthly data",
            "updated": "2026-01-22T22:10:23.499Z",
            "provider": "Eurostat",
            "dimensions": [
                {
                    "id": "age",
                    "label": "Age class"
                },
                {
                    "id": "freq",
                    "label": "Time frequency"
                },
                {
                    "id": "geo",
                    "label": "Geopolitical entity (reporting)"
                },
                {
                    "id": "s_adj",
                    "label": "Seasonal adjustment"
                },
                {
                    "id": "sex",
                    "label": "Sex"
                },
                {
                    "id": "unit",
                    "label": "Unit of measure"
                }
            ],
            "description": null,
            "series_count": 2059
        }
    },
    "meta": {
        "timestamp": "2026-06-01T08:13:38.545Z",
        "request_id": "619cf696-e5e9-457b-b847-1bd67f19e4ca"
    },
    "status": "ok",
    "message": "Dataset retrieved",
    "success": true
}
```

#### `GET /v1/series` — Series observations

**Parameters:**
- `provider` (query, required, string) — Provider code Example: `Eurostat`
- `dataset` (query, required, string) — Dataset code Example: `une_rt_m`
- `series` (query, optional, string) — A specific series code
- `limit` (query, optional, string) — Max series (1-50)

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/dbnomics-api/v1/series?provider=Eurostat&dataset=une_rt_m"
```

**Response:**
```json
{
    "data": {
        "count": 5,
        "total": 2059,
        "series": [
            {
                "name": "Monthly – Unadjusted data (i.e. neither seasonally adjusted nor calendar adjusted data) – Total – Percentage of population in the labour force – Females – Austria",
                "latest": {
                    "value": 5.3,
                    "period": "2025-11"
                },
                "series_code": "M.NSA.TOTAL.PC_ACT.F.AT",
                "observations": [
                    {
                        "value": 5.4,
                        "period": "2009-04"
                    },
                    {
                        "value": 4.9,
                        "period": "2009-05"
                    },
                    {
                        "value": 5.4,
                        "period": "2009-06"
                    },
                    {
                        "value": 5.9,
                        "period": "2009-07"
                    },
                    {
                        "value": 5,
                        "period": "2009-08"
                    },
                    {
                        "value": 6.7,
                        "period": "2009-09"
                    },
                    {
                        "value": 5.8,
                        "period": "2009-10"
                    },
                    {
                        "value": 5.5,
                        "period": "2009-11"
   
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Usage notes

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/dbnomics-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "Economic time series aggregated from 90+ official providers (IMF, OECD, Eurostat, ECB, World Bank, BIS, the US Fed & BLS, national statistics offices…). /v1/providers (filter query=) = the data providers with their code and region; /v1/search?query=inflation (filter provider=Eurostat) = search datasets across all providers, returning each dataset's provider, code, name and series count; /v1/dataset?provider=Eurostat&code=une_rt_m = a dataset's details and its dimensions (the codes you combine to pick a series); /v1/series?provider=Eurostat&dataset=une_rt_m (or add series=M.NSA.TOTAL.PC_ACT.F.AT for one) = the series with their observations (period & value) and the latest data point. Typical flow: search → dataset → series. For World-Bank-specific indicators by country see the World Bank API.",
        "source": "DBnomics API (api.db.nomics.world) — economic data from 90+ providers",
        "endpoints": [
            "/v1/providers",
            "/v1/search",
            "/v1/dataset",
            "/v1/series",
            "/v1/meta"
        ]
    },
    "meta": {
        "timestamp": "2026-06-01T08:13:39.140Z",
        "request_id": "18cc4638-d43d-4f0b-aae7-a62118208a77"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/dbnomics-api
OpenAPI spec: https://www.oanor.com/api/dbnomics-api/openapi.json