Dateno API Methods Overview
This page lists the main read-only methods exposed by the Dateno REST API. For a formal, machine-readable description of each endpoint, see the Dateno REST API Reference.
Unless otherwise noted, all methods are HTTP GET and accept the apikey
query parameter for authentication.
Search API
Endpoints for searching and exploring dataset entries in the search index.
| Name | HTTP | Path | Description |
|---|---|---|---|
| Fetch Single Entry | GET | /search/0.1/entry/{entry_id} | Retrieves a single dataset record by its entry_id and returns it as a dataset card. This is a backward-compatible helper for direct lookup by ID. |
| Search Datasets | GET | /search/0.2/query | Full-text search over datasets. Returns a paginated list of dataset records matching a query string and optional filters, together with optional facet aggregations. |
| Search Datasets via Elastic DSL | POST | /search/0.2/es_search | Advanced search endpoint that accepts a raw Elasticsearch DSL query (and optional post_filter) and returns matching dataset records plus facets. Intended for power users who need full control over the ES query. |
| List Facets | GET | /search/0.2/list_facets | Returns the list of facets available in the search index (facet key, display name and description) so that clients can build filter UIs. |
| Get Facet Values | GET | /search/0.2/get_facet | Returns all values for a single facet (terms aggregation on the given key, up to 5000 values) along with document counts per value. Useful for building filters and showing available options. |
| Get Similar Datasets | GET | /search/0.2/similar/{entry_id} | Returns a list of datasets similar to the given entry_id using Elasticsearch more_like_this over selected fields (by default dataset.title and source.topics). |
Note
For typical integrations you will normally use/search/0.2/queryas the primary search entry point.
Raw Data Access
Low-level access to the raw document stored in the search index.
| Name | HTTP | Path | Description |
|---|---|---|---|
| Fetch Raw Entry | GET | /raw/0.1/entry/{entry_id} | Retrieves a single raw document from the Elasticsearch index by ID, without the higher-level abstraction used in the Search API. Primarily intended for debugging and internal tooling. |
Data Catalogs API
Endpoints for working with the Dateno registry of data catalogs.
| Name | HTTP | Path | Description |
|---|---|---|---|
| Fetch Single Catalog | GET | /registry/catalog/{catalog_id} | Retrieves a catalog record (catalog card) by its unique identifier catalog_id. |
| Search Catalogs | GET | /registry/search/catalogs/ | Searches data catalogs by full-text query and optional filters such as software, owner type, catalog type and countries. Returns a paginated list of catalog descriptors. |
Statistics API (statsdb)
Endpoints for exploring and exporting structured statistical datasets managed by the Dateno statistics database.
Namespaces and tables
| Name | HTTP | Path | Description |
|---|---|---|---|
| List Namespaces | GET | /statsdb/0.1/ns | Lists available namespaces (logical databases) in the statistics store. |
| Get Namespace Metadata | GET | /statsdb/0.1/ns/{ns_id} | Retrieves metadata for a namespace, including the list of tables. |
| List Tables | GET | /statsdb/0.1/ns/{ns_id}/tables | Lists tables available within a given namespace. |
| Get Table Metadata | GET | /statsdb/0.1/ns/{ns_id}/tables/{table_id} | Retrieves detailed table metadata including schema and dimensions. |
Indicators and timeseries
| Name | HTTP | Path | Description |
|---|---|---|---|
| List Indicators | GET | /statsdb/0.1/ns/{ns_id}/indicators | Lists indicators (statistical series identifiers) available in the namespace. |
| Get Indicator Metadata | GET | /statsdb/0.1/ns/{ns_id}/indicators/{ind_id} | Retrieves metadata for a single indicator, including optional metadata fields. |
| List Timeseries | GET | /statsdb/0.1/ns/{ns_id}/ts | Lists timeseries available in the namespace. |
| Get Timeseries Metadata | GET | /statsdb/0.1/ns/{ns_id}/ts/{ts_id} | Retrieves metadata for a single timeseries together with the associated table schema and indicator metadata. |
Exporting data
| Name | HTTP | Path | Description |
|---|---|---|---|
| List Exportable Formats | GET | /statsdb/0.1/list_exportable_formats | Lists file formats that can be used to export timeseries data (for example csv, json, xlsx, parquet, compressed variants, etc.). |
| Export Timeseries Data | GET | /statsdb/0.1/ns/{ns_id}/ts/{ts_id}/export.{fileext} | Exports timeseries data to a file in the requested format (e.g. csv, xlsx, json). The response is a file download with an appropriate MIME type. |
Service / Health
Endpoints for checking the health of the Dateno API service.
| Name | HTTP | Path | Description |
|---|---|---|---|
| Health Check | GET | /healthz | Liveness and basic dependency health probe. Performs shallow checks for Elasticsearch, MongoDB and DuckDB and returns overall status along with the application version. |
For details on authentication, accounts and API keys, see: