Developer platform
The history API
Every day of recorded history, as clean JSON, CSV or RSS. Free tier: 1,000 calls a day. Send your key in the x-api-key header.
curl "https://timescope.ai/api/public/v1/today?limit=5" \ -H "x-api-key: ts_live_..."
Your API keys
Sign in to mint a free key.
Endpoints
GET /api/public/v1/today?limit=10Everything recorded for today
GET /api/public/v1/history?date=20-july-1969Full day payload for any date
GET /api/public/v1/events?date=20-july&limit=25Events only
GET /api/public/v1/births?date=14-marchPeople born on a date
GET /api/public/v1/deaths?date=5-mayPeople who died on a date
GET /api/public/v1/photos?date=20-july-1969Archive images for a date
GET /api/public/v1/search?date=20-july&q=moonKeyword search inside a day
GET /api/public/v1/person?date=14-march&name=einsteinMatch a person across a day
GET /api/public/v1/country?date=15-august&q=indiaFilter a day by place
GET /api/public/v1/timeline?date=20-july&from=1900&to=2000Year-ranged timeline slice
GET /api/public/v1/calendar?month=7&year=1969A whole month of date links
GET /api/public/v1/discover?limit=20Trending and most-shared dates
GET /api/public/v1/story?date=20-july-1969&mode=kidsCached AI story for a date
GET /api/public/v1/newspaper?date=20-july-1969&edition=worldCached front page for a date
Formats & limits
- Add
?format=csvor?format=rssto any endpoint. - Responses are cached for an hour; AI stories and newspapers are served from cache only.
- Quota headers:
X-RateLimit-LimitandX-RateLimit-Remaining. Over quota returns 429. - Attribution required on the free tier — link back to TimeScope AI. Need more? see widgets.