按内部编号、IMDb 或 TMDb 编号获取单部电影或剧集,并返回全球流媒体上架信息
查看 流媒体观看平台与片库查询 的全部接口 →根据路径中的 id 获取单部作品的详细信息及其流媒体上架情况。id 可以是内部作品编号、IMDb 编号(tt 加数字,例如泰坦尼克号的 tt0120338),也可以是 TMDb 编号:电影写作 movie/<数字>,剧集写作 tv/<数字>(例如 movie/597 或 tv/1396),编号类型会被自动识别。可选的查询参数有 country、output_language 和 series_granularity。country 为 ISO 3166-1 alpha-2 国家代码:不传时返回所有国家的上架信息;传入后只包含该国家,这也是获得更小、更快响应的推荐做法。output_language 支持 en、es、tr 或 fr(默认 en)。series_granularity 支持 show、season 或 episode,只对剧集生效,本接口的默认值是 episode,如果不需要季和集信息,请选择 show。示例调用(id 为 tt0120338、country 为 us、series_granularity 为 show)返回 HTTP 200 和一个 JSON 对象,内容是电影《泰坦尼克号》(内部编号 136),包含 itemType、showType、id、imdbId、tmdbId、title、originalTitle、overview、releaseYear、genres(由 id 和 name 组成的键值对)、directors、cast、rating、runtime、imageSet 和 streamingOptions。streamingOptions 是以国家代码为键的对象(示例中只有 us),其下的选项包含 service、type、link、audios、subtitles、expiresSoon 和 availableSince,多数选项还有 quality;出现过的类型有 subscription、free、rent、buy 和 addon,租赁和购买类选项还带有 price 对象(amount、currency、formatted),部分选项另有 expiresOn 或 videoLink。示例调用没有覆盖的内容包括:TMDb 编号写法、不带 country 的调用,以及文档中给出的 404 错误响应体(带有 message 字段的 JSON 对象)。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/streaming-availability/get-show API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/streaming-availability/get-show?key=<API_KEY>&id=<id>&output_language=en&series_granularity=episode'
查询结果
使用场景
- 影评或资讯页面上的「在哪看」组件,直接使用文章元数据里已有的 IMDb 编号查询
- 为单部作品生成跨国家上架对比表:不传 country 调用,再按国家代码分组
- 每晚按编号刷新片单中的记录,发现有新平台开始上线该作品
- 预算友好视图:只保留免费和订阅类选项,隐藏租赁与购买条目
- 为媒体服务器里的资料库条目补充其他地区有哪些平台提供同一部作品
- 剧集详情页通过深链把观众直接带到具体的某一季或某一集
常见问题
id 路径值支持哪些编号格式?
支持内部作品编号、tt 加数字的 IMDb 编号(例如 tt0120338),以及 TMDb 编号:电影写作 movie/<数字>,剧集写作 tv/<数字>(例如 tv/1396)。类型会被自动识别。示例调用用的是 IMDb 格式;TMDb 格式在文档中有说明但未实际验证,而且它含有斜杠,请确认你的客户端按预期发送了该路径。
不传 country 参数会怎样?
根据文档,响应会包含所有国家的流媒体上架信息,而不是单个国家。传入 country 会把结果限定在该市场,如果只需要单个国家,推荐这样做,响应更小也更快。示例调用传入了 country 为 us,返回的 streamingOptions 对象里只有 us 一个键。
为什么本接口的 series_granularity 默认是 episode,而搜索接口默认是 show?
两个接口各自定义了默认值。这里默认为 episode,因此除非传入 show 或 season,否则剧集响应会包含季、集信息和深链。电影不受影响。示例调用对一部电影传入了 show。
作品对象里包含哪些字段?
示例调用中包含:itemType、showType、id、imdbId、tmdbId、title、originalTitle、overview、releaseYear、genres、directors、cast、rating、runtime、imageSet 和 streamingOptions。《泰坦尼克号》的响应里,directors 为 James Cameron,genres 是由 id 和 name 组成的键值对,例如 drama 和 romance。
怎样只显示免费或订阅类选项?
本接口没有服务端筛选功能。streamingOptions 中的每个条目都有 type 字段,示例中出现了 subscription、free、rent、buy 和 addon,请在你自己的代码里按该字段过滤。租赁和购买条目带有 price,addon 条目带有标明频道的 addon 对象。
如何判断某个选项快要下架?
示例中的每个选项都有 expiresSoon 布尔值和 availableSince 时间戳,部分还有 expiresOn。可以保存这些字段,并在每次刷新时对比,以发现即将离开某个平台的作品。
查询的作品不存在时会返回什么?
源文档给出了一个 404 示例,响应体是带有 message 字段的 JSON 对象(示例中为空)。示例调用没有触发这种情况,因此具体的错误文本尚未经过验证,请不要依赖它。
响应里的图片链接会长期有效吗?
不会。示例中的图片链接带有 Expires 和 Signature 查询参数,请重新请求该作品获取新链接,不要永久保存。imageSet 包含 verticalPoster、horizontalPoster、verticalBackdrop 和 horizontalBackdrop,每种都有多种宽度。