← API.MAO.MS 首页EN

历史上的今天 API

免费、无需密钥。查询任意日期在历史上发生的大事、出生与逝世名人。

数据说明

全量存入本站数据库,定期同步。中文数据为编辑精选,每天约 13 条(大事记 / 出生 / 逝世),多数条目附一段简介——默认不返回,传 desc=1 才带上(简介为纯文本)。覆盖全年 365 天;2 月 29 日当天返回为空。公元前年份以负数表示。本站另提供更全的英文版本,单日条目量可达中文版的数十倍,传 lang=en 使用。

接口文档

基础路径 /v1/history,全部为 GET 请求,返回 {code, message, data}。

GET /v1/history/today 今天

参数默认说明
tzAsia/Shanghai按哪个时区算「今天」,IANA 时区名
type全部可选 event / birth / death,只返回一类
desc不带传 1 时附带每条的简介 description(纯文本,仅中文数据有)
请求:/v1/history/today
返回(节选):{"code":0,"message":"ok","data":{"month":11,"day":12,"date":"2026-11-12","counts":{"event":4,"birth":5,"death":3,"total":12},"events":[{"year":1035,"text":"丹麦和英国国王克努特大帝去世"},…]}}

GET /v1/history/day 指定日期

参数默认说明
month必填月份 1–12
day必填日期,须在该月范围内(2 月按 29 天)
type全部可选 event / birth / death,只返回一类
desc不带传 1 时附带每条的简介 description(纯文本,仅中文数据有)
请求:/v1/history/day?month=11&day=12&type=birth&desc=1
返回(节选):{"code":0,"message":"ok","data":{"month":11,"day":12,"counts":{"event":4,"birth":5,"death":3,"total":12},"births":[{"year":1840,"text":"法国著名法国雕塑艺术家奥古斯特·罗丹出生","description":"罗丹是法国著名雕塑家。他在欧洲雕塑史上的地位,正如诗人但丁在欧洲文学史上的地位……"},…]}}

调用统计

历史上的今天接口累计被调用 4 次 · 今日 4 次。全部接口统计见 调用统计页。

接口路径今日累计
今日/v1/history/today22
指定日期/v1/history/day22
接口索引/v1/history00

在线测试

月 日
点「今天」或选个日期查询,这里会显示真实数据。