Overview

Base URL

All endpoints are served under:

https://aesops.co.ke/api/v1

Public vs. gated

• GET /datasets and GET /datasets/{slug} are fully public — no API key is required or checked. The full catalog (keyless and gated datasets alike) is shown for discovery.
• GET /datasets/{slug}/data — the endpoint that returns an actual signed download URL — requires a read-scoped API key, unless the dataset is currently "keyless" (see below). See Authentication for how to create one.

Keyless datasets

A dataset can be marked keyless for a limited window (keyless_until in the API response). While that window is active, /data can be called with no API key at all. Outside the window — or for datasets that were never marked keyless — a valid read-scoped key is required. An invalid key is always rejected with 401, even against a keyless dataset.

Pagination

GET /datasets is paginated via page (default 1) and page_size (default 20, capped at 100). The response includes total, page, and page_size alongside items.

Errors

Errors are returned as { "error": "<message>" } with a matching HTTP status code. See each endpoint's reference page for its specific error cases.