TVMaze

简介

TVMaze 的公开 API 是电视节目数据的最佳免费来源：剧集、单集、季度、演员、图片、节目表和内嵌的 web/单集信息——免密钥且定期更新。是追剧应用、单集日历和“今晚演什么”小组件的经典选择。

快速开始

搜索剧集（实测可用——绝命毒师）：

curl "https://api.tvmaze.com/singlesearch/shows?q=breaking+bad"

内嵌单集与演员：

curl "https://api.tvmaze.com/singlesearch/shows?q=breaking+bad&embed=episodes"
curl "https://api.tvmaze.com/singlesearch/shows?q=breaking+bad&embed=cast"

按 TVmaze ID 查询：

curl "https://api.tvmaze.com/shows/169"

单集列表：

curl "https://api.tvmaze.com/shows/169/episodes"

今日节目表（美国）：

curl "https://api.tvmaze.com/schedule?country=US"

认证方式

无需认证——免密钥。

速率限制与注意事项

• 免费，没有文档化的硬性限制——但文档要求每 10 秒不超过 20 次请求，并设置合理的 User-Agent。
• embed=episodes|cast|seasons 可在单次响应中内嵌更多数据（减少往返）。
• 剧集/单集 ID 稳定；单集带播出日期和季度号，适合日历应用。
• schedule 支持 country、date 和 web 筛选。

常见问题

TVMaze 免费吗？ 是的——免费且免密钥（请礼貌使用：约 20 次/10 秒）。

能一次调用获取单集和演员吗？ 可以——embed=episodes,cast 会内嵌返回。

如何按名称找剧？ /singlesearch/shows?q=名称 返回最佳匹配。