Skip to content

Data Management API

R2 Raw Dataset and Metadata Snapshot/Synchronization API.


Base path: /api/v1/datasets

  • GET /api/v1/datasets — List datasets (country, category query).
  • GET /api/v1/datasets/stats — Dataset statistics.
  • GET /api/v1/datasets/:country/:category/:date — List chunks for a specific date partition.
  • GET /api/v1/datasets/:country/:category/:date/:chunk — Retrieve a specific chunk.
  • POST /api/v1/datasets — Save a dataset (EnhancedResearchDataset).
  • DELETE /api/v1/datasets/:country/:category/:date/:chunk — Delete chunk.

Base path: /api/v1/metadata

  • GET /api/v1/metadata/snapshot — Full snapshot metadata (for GitHub Actions synchronization).
  • POST /api/v1/metadata/sync — Synchronize snapshot to GitHub.
  • GET /api/v1/metadata/by-country/:country — Metadata by country.
  • GET /api/v1/metadata/tasks — List/status of metadata tasks.

  • Implementation: src/routes/datasets.ts , src/routes/metadata.ts