给网站、小程序或博客加一个「历史上的今天」板块，或者做历史教育类工具时，第一反应往往是「找个免费接口直接调」。社区里流传的免费方案不少，但接口时效性强、今天能用明天未必通。本文对流传较广的方案做了一次实测，列出当前仍可接入的免费 / 免费额度方案，供按需自取。
一、可用方案清单
实测后仍可正常接入的方案，按「是否需注册密钥」大致分为两类：
-
万维易源（showapi）历史上的今天 ------ 官方自营免费服务，需免费 appKey。
-
接口盒子（apihz.cn）历史上的今天 ------ 免费注册得 ID/key，已实测返回真实数据。
-
聚合数据 历史上的今天 API ------ 免费调用额度，需注册 key。
-
APISpace 历史上的今天 API ------ 注册后送免费调用次数，需 Token。
二、免费接口推荐
1、万维易源（showapi）历史上的今天
-
官方自营 · 稳定可信 · 返回含图文详情 · 需免费 appKey
-
接口地址：
https://route.showapi.com/119-42?appKey={your_appKey} -
请求方式： POST / GET，返回 JSON。
-
主要参数：
date（如0818表示 8 月 18 日，不填默认当天）、needContent（1返回事件详细内容，0不返回）。 -
返回字段：
list数组，每项含day/title/year/month/content/img；ret_code为 0 表示成功。 -
实测情况： 未带 key 时返回结构化错误
{"showapi_res_code":-1004,"showapi_res_error":"appKey err"}，说明服务在线；带合法 appKey 即正常返回数据。appKey 需在控制台免费获取。
2、接口盒子（apihz.cn）历史上的今天
-
免费注册得 ID/key · 数据同步百度百科 · 已实测返回
-
接口地址：
https://cn.apihz.cn/api/zici/today.php -
请求方式： GET / POST。
-
主要参数：
id、key（官网免费注册获取）；m（1--12 月）、d（1--31 日），需同时传；不传m/d时默认返回当日随机事件。 -
返回字段：
code（200 成功 / 400 错误）、title、y、m、d、words（关键词）、url（百度百科链接）。 -
实测情况（2026-08-18）：
{"code":200,"title":"单届世界杯进球最高纪录保持者方丹出生。","y":"1933","m":"08","d":"18","words":"世界杯","url":"https://baike.baidu.com/item/%E6%96%B9%E4%B8%B9"}
注：公共测试 id/key（88888888 / 88888888）有频次限制，正式使用请在接口盒子注册独享 ID/key（免费）。
3、聚合数据 历史上的今天 API
-
免费调用额度 · 需注册 key · 接口文档齐全
-
接口文档：
https://www.juhe.cn/docs/api/id/63 -
调用地址：
http://api.juheapi.com/japi/toh?key=KEY&v=1.0&month=8&day=18 -
请求方式： GET / POST。
-
返回字段：
result数组，每项含day/des（事件描述）/id/lunar（农历）/month/pic/title/year。 -
说明： 新用户注册后有一定免费调用额度，超出后按量计费；适合已经在用聚合数据其他接口、希望统一接入的项目。
4、APISpace 历史上的今天 API
-
注册送免费调用次数 · 请求头携带 Token
-
平台：
https://www.apispace.com -
鉴权方式： 在请求头中携带
X-APISpace-Token（在控制台或测试页获取后粘贴）。 -
覆盖范围： 国家大事、国际事件、政府重要决策部署等图文详情。
-
说明： 注册账号后即可申请并免费调用一定次数，适合已在 APISpace 生态内、希望一处管理多个接口的场景。
三、参数速览表
| 方案 | 请求方式 | 鉴权 | 返回形式 | 典型限制 |
|---|---|---|---|---|
| 万维易源 showapi | POST / GET | appKey | JSON（含图文 content/img） | 免费服务，按需免费额度 |
| 接口盒子 apihz.cn | GET / POST | id + key | JSON（含百度百科 url） | 公共 ID 频次受限，建议注册独享 |
| 聚合数据 juhe | GET / POST | key | JSON（含农历 lunar） | 免费额度，超出按量 |
| APISpace | GET / POST | X-APISpace-Token 头 | JSON（图文详情） | 注册送免费次数 |
四、场景化选型建议
-
希望数据长期稳定、由官方自营维护、且需要图文详情（content + img）：可考虑万维易源 showapi。
-
希望接入最简单、免费且无需复杂鉴权、数据带百度百科链接便于二次跳转：可考虑接口盒子 apihz.cn。
-
项目已在用聚合数据或 APISpace 的其他接口、希望统一密钥管理：可考虑对应平台的同名接口。
-
调用量较大或用于生产环境：建议注册独享密钥并关注各平台的限流策略，必要时评估商业套餐。
五、实战代码示例
万维易源 showapi
# curl
curl -X POST "https://route.showapi.com/119-42?appKey=YOUR_APPKEY" \
-H "content-type: application/x-www-form-urlencoded" \
-d "date=0818&needContent=1"
# Python
import requests
url = "https://route.showapi.com/119-42"
r = requests.post(url, params={"appKey": "YOUR_APPKEY"},
data={"date": "0818", "needContent": "1"})
print(r.json()["showapi_res_body"]["list"])
接口盒子 apihz.cn
# curl
curl "https://cn.apihz.cn/api/zici/today.php?id=YOUR_ID&key=YOUR_KEY&m=08&d=18"
# Python
import requests
r = requests.get("https://cn.apihz.cn/api/zici/today.php", params={``
"id": "YOUR_ID", "key": "YOUR_KEY", "m": "08", "d": "18"
})
print(r.json())
六、FAQ
Q：没有 key 的「纯免费直连」接口还有吗？
A：本次实测中，社区早先流传的多个免 key 直连接口（oick、oioweb、pearktrue、aa1、vvhan、qqsuu 等）均已失效。当前可用的免费方案基本都需要先注册一个免费密钥（appKey / id+key / Token），注册本身免费。
Q：公共测试 ID 报「调用频次过快」怎么办？
A：这是共享公共 ID 被限流所致，并非接口故障。到对应平台注册自己的密钥即可独享调用频次。
Q：返回内容能直接用于商业产品吗？
A：请留意各平台的服务条款与数据版权（部分数据同步自百度百科等公开来源），正式商用前确认授权范围。
本文基于 2026-08-18 的实测请求整理，接口可用性会随服务商策略变化，正式接入前建议再自行测试一次。