Public API Reference
All endpoints are public and return JSON. No authentication required for read access.
Base URL: https://data.copamis.fr
Contents
List Datasets
Returns all public datasets with metadata.
GET
/api/datasets
| Param | Type | Description |
|---|---|---|
| q | string | Full-text search filter |
| tag | string | Filter by tag |
| topic | string | Filter by topic slug |
Example:
https://data.copamis.fr/api/datasets?q=gdp
Dataset Detail
Returns metadata + statistics for a single dataset.
GET
/api/datasets/{slug}
Returns: obs_count, entity_count, last_value, last_value_period + full metadata.
https://data.copamis.fr/api/datasets/fr-elections-presidentielle
Dataset Observations
Returns time-series observations. Supports filtering and multiple export formats.
GET
/api/datasets/{slug}/data
| Param | Type | Description |
|---|---|---|
| entity | string | Entity code (ISO3, NUTS2, etc.) |
| from | date | Start period (YYYY-MM-DD) |
| to | date | End period (YYYY-MM-DD) |
| fmt | string | json (default) | csv | xlsx | parquet |
| limit | int | Max rows (default 5000) |
Examples:
https://data.copamis.fr/api/datasets/fr-elections-presidentielle/data?entity=FRA&from=2010-01-01
https://data.copamis.fr/api/datasets/fr-elections-presidentielle/data?fmt=csv
Search
Full-text search across dataset names, descriptions and tags.
GET
/api/search?q={query}
https://data.copamis.fr/api/search?q=inflation
Entities
Returns all datasets linked to a country/region entity.
GET
/api/entities/{code}
https://data.copamis.fr/api/entities/FRA
Dataset Snapshots
Historical snapshots of obs_count / entity_count after each ingest.
GET
/api/datasets/{slug}/snapshots
https://data.copamis.fr/api/datasets/fr-elections-presidentielle/snapshots
Export Formats
Append ?fmt= to the data endpoint.
| Format | MIME type | Notes |
|---|---|---|
| json | application/json | Default. Returns {"data": [...], "meta": {...}} |
| csv | text/csv | UTF-8 with BOM for Excel compatibility |
| xlsx | application/vnd.openxmlformats… | Excel workbook with metadata sheet |
| parquet | application/octet-stream | Apache Parquet (columnar, ideal for analytics) |
Rate limits: No hard rate limits are enforced. Please be considerate — cache responses locally and avoid scraping at high frequency. For bulk access, download the Parquet or CSV export once rather than paginating JSON.