系列「每天一个高质量 API」第 25 篇。搜蚁智选（souyi.net.cn）是一个面向 AI Agent 的 API 发现与统一调用平台。今天聊 TVMaze 电视节目检索（free-tv-tvmaze）。
给 Agent 一个关键词，拿到匹配的剧集：剧名、电视台、首播年、状态与评分——影视推荐第一步。
这个 API 能做什么
TVMaze 的 /search/shows?q= 返回剧集数组，每条 show 含 id、name、network、premiered、status、rating.average、genres[]。适合做影视推荐 / 资讯类 Agent。
为什么 AI Agent 需要它
- 观影推荐 Agent：按题材或关键词检索并打分排序。
- 资讯简报：某剧「完结 / 续订」状态变化时推送。
- 元数据补全：用 id 拉详情页做知识卡片。
怎么用
方式一：直连上游（免费、无需 Key）
curl "https://api.tvmaze.com/search/shows?q=games"方式二：经搜蚁智选一键调用（带 Key，统一计费 / 限流 / 可观测）
curl -X POST https://souyi.net.cn/api/v1/ai/request \
-H "X-API-Key: YOUR_AIMALL_KEY" \
-H "Content-Type: application/json" \
-d '{"asset_id":"free-tv-tvmaze","call_data":{"q":"games"}}'这些免费 API 的上游本身免密；经搜蚁智选代理后，多个数据源可以聚合到同一个 Agent 工作流里，统一走 X-API-Key + 统一计费、限流与可观测，省去每个上游单独接一遍。
返回示例
[
{"score":0.6806,"show":{
"id":3209,"name":"Brain Games",
"network":{"name":"National Geographic"},
"premiered":"2011-10-09","status":"Ended",
"rating":{"average":6.6}}}
]价格
免费。TVMaze 公开 API 免密；高频请自觉限速。
怎么拿到 Key
注册 souyi.net.cn → 控制台一键生成 X-API-Key → 即可调用平台全部 API（含本系列 34 个）。
小结
影视 Agent 的检索入口。TVMaze 把「剧名 + 电视台 + 评分」一次性给全，推荐与简报直接能跑。
下一篇（Day 26）：TheMealDB 随机食谱（free-meal-themealdb）。系列持续更新，关注不迷路。