Developer API — Histories Today

Today in History — Public API

A simple, read-only JSON API giving access to historical events from Histories Today. Free tier: 500 requests / day per key.

Authentication: include your key in the X-Api-Key request header. Request a key.

Endpoints

GET /api/v1/today Up to 10 events for today 
curl https://historiestoday.com/api/v1/today \
  -H "X-Api-Key: YOUR_KEY"
{ "date": "July 20", "month": 7, "day": 20, "count": 10,
  "events": [ { "id": 1234, "slug": "...", "title": "...",
               "year": "1969", "era": "AD", "description": "...",
               "date": { "month": 7, "day": 20 },
               "eventType": "Event", "eventTypeSlug": "events",
               "likes": 42, "views": 380, "comments": 5,
               "imageUrl": "https://...", "url": "https://historiestoday.com/event/..." } ] }
GET /api/v1/date/{month}/{day} Events for any calendar date

Optional query params: type (events | births | deaths | holidays | selected), limit (1–100, default 20). 

GET https://historiestoday.com/api/v1/date/7/20?type=births&limit=5
X-Api-Key: YOUR_KEY
GET /api/v1/event/{slug} Single event with tags 
GET https://historiestoday.com/api/v1/event/apollo-11-moon-landing
X-Api-Key: YOUR_KEY
GET /api/v1/search?q=… Full-text search

Required: q (min 2 chars). Optional: type, limit (1–50). 

GET https://historiestoday.com/api/v1/search?q=moon+landing&limit=10
X-Api-Key: YOUR_KEY

Error responses

StatusMeaning
401Missing or invalid API key
400Invalid parameters
404Event not found
429Rate limit exceeded (resets midnight UTC)

All responses are application/json. Data is available under CC BY-SA 4.0. Please credit Histories Today when using this API.