DBnomics

DBnomics is the world's economic database - a free, open-source aggregator run by Cepremap that harvests macroeconomic time series from more than 90 national and international providers (IMF, ECB, Eurostat, World Bank, OECD, BLS, BEA, Banque de France, Federal Statistical Office Germany, and many more) into one standardized format. Hundreds of millions of series covering economic indicators, government statistics, prices, employment, trade, and finance are refreshed daily and served through a documented public REST API (api.db.nomics.world/v22) that requires no API key, plus official Python and R clients and community clients for Julia, Matlab, Stata, EViews, and Gretl.

4 APIs 0 Features
Economic IndicatorsMacroeconomicsOpen DataStatisticsTime SeriesGovernment Data

APIs

DBnomics Providers API

List the 90+ statistical agencies, central banks, and international institutions aggregated by DBnomics, or retrieve a single provider with its full category tree of datasets. N...

DBnomics Datasets API

Retrieve dataset metadata for any provider - one dataset or the paginated list of a provider's datasets, including dimensions, series counts, and update timestamps - plus a last...

DBnomics Series API

Fetch economic time series and their observations - by explicit series IDs across providers, by provider and dataset with dimension filters or series-code masks, or as a single ...

DBnomics Search API

Full-text search across every dataset aggregated by DBnomics - find economic indicators, government statistics, and macroeconomic series by keyword with simple limit/offset pagi...

Collections

DBnomics API

OPEN

Pricing Plans

Dbnomics Plans Pricing

2 plans

PLANS

Rate Limits

Dbnomics Rate Limits

3 limits

RATE LIMITS

FinOps

Dbnomics Finops

FINOPS

Resources

🔗
DomainSecurity
DomainSecurity
🔗
Website
Website
🔗
Documentation
Documentation
👥
GitHubOrganization
GitHubOrganization
🔗
Plans
Plans
🔗
RateLimits
RateLimits
🔗
FinOps
FinOps

Sources

Raw ↑ 
opencollection: 1.0.0
info:
  name: DBnomics API
  version: 22.1.17
items:
- info:
    name: Providers
    type: folder
  items:
  - info:
      name: List providers
      type: http
    http:
      method: GET
      url: https://api.db.nomics.world/v22/providers?limit=50&offset=0
    docs: Lists the 90+ statistical agencies, central banks, and international institutions aggregated by DBnomics.
  - info:
      name: Retrieve a provider
      type: http
    http:
      method: GET
      url: https://api.db.nomics.world/v22/providers/:provider_code
      params:
      - name: provider_code
        value: IMF
        type: path
        description: Code of the provider (e.g. IMF, ECB, Eurostat, BLS).
    docs: Retrieves a provider with its full category tree of datasets.
- info:
    name: Datasets
    type: folder
  items:
  - info:
      name: List datasets of a provider
      type: http
    http:
      method: GET
      url: https://api.db.nomics.world/v22/datasets/:provider_code?limit=50&offset=0
      params:
      - name: provider_code
        value: AMECO
        type: path
        description: Code of the provider.
    docs: Lists the datasets of a provider with metadata, dimensions, and series counts.
  - info:
      name: Retrieve a dataset
      type: http
    http:
      method: GET
      url: https://api.db.nomics.world/v22/datasets/:provider_code/:dataset_code
      params:
      - name: provider_code
        value: AMECO
        type: path
        description: Code of the provider.
      - name: dataset_code
        value: ZUTN
        type: path
        description: Code of the dataset.
    docs: Retrieves a single dataset of a provider.
  - info:
      name: List last updates
      type: http
    http:
      method: GET
      url: https://api.db.nomics.world/v22/last-updates?datasets.limit=20&providers.limit=20
    docs: Lists providers and datasets sorted by creation/conversion date, most recent first.
- info:
    name: Series
    type: folder
  items:
  - info:
      name: Retrieve series by IDs
      type: http
    http:
      method: GET
      url: https://api.db.nomics.world/v22/series?series_ids=ECB/RTD/A.S0.N.F_CEC_CGG_D0.F&observations=true
    docs: Retrieves series found by IDs (provider_code/dataset_code/series_code), potentially across providers and datasets.
  - info:
      name: List series of a dataset
      type: http
    http:
      method: GET
      url: https://api.db.nomics.world/v22/series/:provider_code/:dataset_code?observations=false&limit=100
      params:
      - name: provider_code
        value: ECB
        type: path
        description: Code of the provider.
      - name: dataset_code
        value: RTD
        type: path
        description: Code of the dataset.
    docs: Lists series belonging to the same dataset, filterable by dimensions or full-text query.
  - info:
      name: Retrieve series by code or mask
      type: http
    http:
      method: GET
      url: https://api.db.nomics.world/v22/series/:provider_code/:dataset_code/:series_code?observations=true
      params:
      - name: provider_code
        value: ECB
        type: path
        description: Code of the provider.
      - name: dataset_code
        value: RTD
        type: path
        description: Code of the dataset.
      - name: series_code
        value: A.S0.N.F_CEC_CGG_D0.F
        type: path
        description: A series code or series code mask (dimension filter).
    docs: Retrieves series matching a series code or series code mask, optionally with observations in JSON or CSV.
- info:
    name: Search
    type: folder
  items:
  - info:
      name: Full-text search of datasets
      type: http
    http:
      method: GET
      url: https://api.db.nomics.world/v22/search?q=inflation&limit=20&offset=0
    docs: Full-text search across every dataset aggregated by DBnomics.