← API.MAO.MS home中文

On This Day API

Free, no key required. Historical events, births and deaths for any day of the year.

About the data

Stored in full in our own database and re-synced periodically. The English dataset is the more comprehensive one — several hundred entries per day across events, births and deaths, covering all 366 days including Feb 29; BC years are negative numbers. A Chinese edition better suited for readers in China is also provided — just pass lang=zh. Data obtained from Wikipedia under the CC BY-SA license.

API reference

Base path /v1/history. All endpoints are GET and return {code, message, data}. Add lang=en for English error messages.

GET /v1/history/today Today

ParameterDefaultNotes
tzAsia/ShanghaiTimezone that defines "today" (IANA name)
typeallOptional event / birth / death to return a single group
descomittedPass 1 to include a plain-text description per entry (only the Chinese data has descriptions; English entries have none)
Request: /v1/history/today
Response (excerpt): {"code":0,"message":"ok","data":{"month":11,"day":12,"date":"2026-11-12","counts":{"event":63,"birth":187,"death":99,"total":349},"events":[{"year":954,"text":"The 13-year-old Lothair III is crowned at the Abbey of Saint-Remi as king of France."},…]}}

GET /v1/history/day A specific date

ParameterDefaultNotes
monthrequired1–12
dayrequiredMust fit the month (February counts 29 days)
typeallOptional event / birth / death
descomittedPass 1 to include a plain-text description per entry (only the Chinese data has descriptions; English entries have none)
Request: /v1/history/day?month=11&day=12&type=birth
Response (excerpt): {"code":0,"message":"ok","data":{"month":11,"day":12,"counts":{"event":63,"birth":187,"death":99,"total":349},"births":[{"year":1840,"text":"Auguste Rodin, French sculptor (d. 1917)"},…]}}

Usage stats

The On This Day endpoints have been called 4 times in total · 4 today. See the full usage stats.

EndpointPathTodayTotal
Today/v1/history/today22
By date/v1/history/day22
Index/v1/history00

Live test

Month Day
Press "Today" or pick a date — the live data will appear here.