按内部编号、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 功能

一个路径位置支持三种编号 id 路径段可自动识别内部编号、tt0120338 这样的 IMDb 编号,以及 movie/597 或 tv/1396 这样的 TMDb 编号,你手头存的是哪种编号就用哪种查。
可选 country 参数,让响应更精简 传入 country 后,streamingOptions 只保留该国家市场的数据;如果只关心单个国家,文档也推荐这样做。
不传 country 即得全球上架情况 省略 country,响应会涵盖所有国家的流媒体上架信息,一次请求就能看到同一部作品的跨地区全貌。
完整的作品档案,含主创与海报 除上架信息外,还返回剧情简介、上映年份、类型、导演、演员、评分、片长,以及由竖版和横版海报与背景图组成的四类 imageSet。
每个选项都带深链与到期字段 每个播放选项包含平台、link 跳转链接、可选的 videoLink、画质、带听障字幕标记的音轨和字幕列表,以及 expiresSoon、availableSince,部分还有 expiresOn。
剧集默认返回分集级详情 series_granularity 在本接口默认为 episode,会附带季和集的播放信息及深链;改为 show 或 season 可以缩小返回体。

在线 API 演示

GET /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'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

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,每种都有多种宽度。

相关接口

相关指南

查看订阅方案 →