# 历史上的今天
**请求方式:** GET
**接口地址:** https://api.hk0.cc/api/history
**接口描述:** 历史上的今天: 按日期返回中外历史事件(百度百科数据), 含年份、标题、简介、百科链接与事件类型(出生/逝世/事件); 支持任意日期与年份筛选, 按月缓存 30 天。
## 请求参数
| 参数名 | 可传值说明 | 传入位置 | 是否必填 | 示例值 | 默认值 | 参数说明 |
|--------|----------|----------|----------|--------|--------|----------|
| date | string | query | 可选 | — | — | 日期, 支持 MMDD / MM-DD / YYYY-MM-DD / YYYYMMDD, 默认今天; 也可用 month + dd 分开传。也接受 d/day |
| year | string | query | 可选 | — | — | 只返回指定年份的事件, 如 1949 或 -700(公元前)。也接受 y |
| limit | int | query | 可选 | — | — | 返回条数, 0 表示全部(默认 0)。也接受 n/count |
| clean | int | query | 可选 | — | — | 默认 1 去除 HTML 标签返回纯文本; 传 0 保留原始 HTML |
| fresh | int | query | 可选 | — | — | 传 1 跳过缓存强制刷新 |
## 返回示例
```json
{
"code": 200,
"msg": "success",
"data": {
"date": "11-18",
"date_compact": "1118",
"month": 11,
"day": 18,
"label": "11月18日",
"total": 15,
"count": 2,
"source": "baidu",
"list": [
{
"year": "-700",
"year_label": "公元前700年",
"title": "卫国君主卫宣公逝世",
"desc": "卫宣公,姬姓,卫氏,名晋,卫庄公之子,卫桓公之弟,春秋时期卫国第十五任国君,前718年—前700年在位。",
"link": "https://baike.baidu.com/item/%E5%8D%AB%E5%AE%A3%E5%85%AC",
"type": "death"
},
{
"year": "763",
"year_label": "763年",
"title": "吐蕃军入长安",
"desc": "吐(tǔ)蕃(bō ),是由古代藏族在青藏高原建立的政权,自松赞干布至朗达玛传位九代,延续两百多年(公元633年—842年)。",
"link": "https://baike.baidu.com/item/%E5%90%90%E8%95%83",
"type": "event"
}
]
}
}
```