Base URL: https://mac-daily.com/api/v1
Machine-readable: /api/v1/openapi.json (OpenAPI 3.1).
Endpoints
Example response/api/v1/answers · 0 rows
{
"apiVersion": "v1",
"generatedAt": "2026-01-01T00:00:00.000Z",
"license": {
"data": "https://creativecommons.org/licenses/by/4.0/",
"dataName": "CC BY 4.0",
"prose": "All rights reserved"
},
"count": 0,
"items": []
}Filters are exact, case-insensitive matches. A slug can span locales, so the item endpoints return an array; narrow with ?locale.
Pagination
limit defaults to 50, clamped to 1..200. offset is a zero-based index (default 0). List responses carry total for paging.
Rate limit
60 requests/minute and 5000/day per IP. Every response carries X-RateLimit-* headers; a 429 adds Retry-After (seconds).
Response envelopes
# list
{ "collection", "total", "limit", "offset", "count", "items": [ … ] }
# item (items is an array — a slug can span locales)
{ "collection", "count", "items": [ … ] }
# error
{ "error", "message", "retryAfter"? }Example
curl "https://mac-daily.com/api/v1/figures?country=ZA&metric=production&limit=10"
Licence
Index data (figures, datasets) is licensed CC BY 4.0 — reuse it with attribution to Mac Daily. Article prose is All rights reserved. The full terms are on the editorial charter.