Skip to main content

Dateno REST API Overview

The Dateno REST API (v2) provides read-only, HTTP-based access to the curated dataset registry and statistics store behind the Dateno platform.

You can use the API to search for datasets, fetch dataset cards, explore data catalogs, work with statistical time series, and monitor the health of the service.

Base URL and authentication​

The primary base URL for the production API is:

https://api.dateno.io/

All endpoints are read-only and use simple API key authentication.
Pass your key as the apikey query parameter:

https://api.dateno.io/search/0.2/query?q=water&limit=10&apikey=YOUR_API_KEY

For details on creating an account and obtaining an API key, see:

What you can do with the API​

Search and explore datasets​

  • Perform full-text search over datasets and filter results with facets
    (for example via /search/0.2/query).
  • Retrieve datasets similar to a given one using the similarity endpoint.
  • Inspect available facets and facet values to build rich filtering UI.

Work with dataset cards​

  • Fetch a single dataset record by its entry_id
    (for example via /search/0.1/entry/{entry_id}).
  • Use the dataset card structure to access metadata and dataset resources
    (see Dataset card).

Explore data catalogs​

  • Search data catalogs and filter them by software, owner type, catalog type or coverage countries.
  • Fetch a single catalog record by its catalog_id.

These endpoints expose the curated registry of data catalogs that Dateno continuously maintains and updates.

Work with statistical datasets​

  • Explore namespaces, tables, indicators and time series managed by the statistics database (statsdb).
  • Export time series data to files in various formats (CSV, JSON, XLSX, etc.) for further analysis.

Service and health checks​

  • Use the /healthz endpoint as a liveness and dependency health probe (Elasticsearch, MongoDB and DuckDB) in your monitoring or orchestration setup.

Key endpoint groups​

The API is organised into several logical groups of endpoints:

  • Search API — searching and exploring dataset entries
  • Raw access — fetching raw index documents by ID
  • Data Catalogs API — working with catalogs that publish datasets
  • Statistics API (statsdb) — exploring and exporting statistical data
  • Service / Health — checking the overall health of the API service

For a detailed list of individual endpoints (HTTP methods, paths and descriptions), see:

Next steps​

If you are new to the Dateno API, we recommend the following path:

  1. Create an account and get your API key
  2. Learn the structure of a dataset card
  3. Browse the API methods and try a few requests against /search/0.2/query