适合什么时候用
完全免费 + 无需 API key
先注意什么
默认 rate limit 较紧（每秒 20 次）
第一步先查
GET https://api.tvmaze.com/shows/1 拿剧集详情；/search/shows?q=arrow 搜索；/shows/1/episodes 拿剧集列表。
认证
—
CORS
不支持
HTTPS
是
注册
?
延迟
616 ms
协议
REST
计费
—
可用率 · 30 天窗口
巡检: 1可用率: 100%平均延迟: 616ms
01
关于这个 API
TVmaze 是 TV 数据领域的免费 API 黑马。和 TMDB（也免费，但兼顾电影和 TV）相比，TVmaze 专注 TV——每集数据更完整、播放渠道（NetFlix、Hulu 还是哪个频道首播）更准。完全免费、不要 API key、文档清晰，对个人追剧 app、字幕项目、TV recommendation 实验都好用。最大特色是「schedule」endpoint：GET /schedule?country=US&date=2024-01-01 拿到那天美国电视台播了什么，做 TV guide 类应用很方便。劣势：rate limit 较紧（20/sec 全站共享），大流量应用要联系官方申请 commercial use。
02
你可以做什么
- 1追剧 app（用户标记看过的剧集）
- 2TV 节目时间表显示
- 3为推荐系统提供 TV metadata
- 4聊天机器人回答 TV 问题
03
优劣对比
优点
- 完全免费 + 无需 API key
- 覆盖美/英/欧/亚主流剧
- 每集数据完整（air date、duration、summary、playback URL）
注意事项
- 默认 rate limit 较紧（每秒 20 次）
- 某些小众剧或新剧入库慢
04
示例请求
通用模板 — 实际 endpoint 请查阅文档替换 <endpoint>。
curl http://www.tvmaze.com/<endpoint>05
快速开始
GET https://api.tvmaze.com/shows/1 拿剧集详情；/search/shows?q=arrow 搜索；/shows/1/episodes 拿剧集列表。
06
常见问题
能查中国/日本剧吗？+
韩剧、日剧、动漫有部分覆盖。中国大陆剧覆盖较弱。
免费够商业用吗？+
小流量 OK。中大流量需要联系 TVmaze 申请 commercial license。
07
技术细节
CORS: NoHTTPS: Yes注册: ?开源: No
- 认证方式
- unknown
- 计费
- unknown
- 协议
- REST
- SDK
- python, javascript, go, java
- 响应时间
- 616 ms
- 上次巡检
- 2026/5/12 07:38:31