查询某国家新上线、已下架、已更新、即将到期和即将上线的影视片库变动

查看 流媒体观看平台与片库查询 的全部接口 →

按国家返回流媒体片库的变动记录,每页 25 条,按变动日期排序。change_type 指定变动类型(new 新上线、removed 已下架、updated 已更新、expiring 即将到期、upcoming 即将上线),item_type 指定条目类型(show 为电影和剧集,按接口文档说明还支持 season 和 episode),country 为 ISO 3166-1 alpha-2 国家代码。还可以用 catalogs(最多 32 个平台选择器)、show_type(movie 或 series,仅在 item_type 为 show 时有意义)、order_direction(asc 或 desc)以及包含边界的 from/to Unix 时间戳继续缩小范围。历史类变动的时间窗口必须落在今天到 31 天前之间,未来类变动则必须落在今天到 31 天后之间。include_unknown_dates 只对未来类变动生效,因为历史变动一定带有时间戳。output_language 用于本地化关联的作品记录(en、es、tr、fr)。翻页时把上一次响应中的 nextCursor 作为 cursor 传入,并先做 URL 转义,因为该值可能包含 ? 和 &;首次请求不需要 cursor。响应包含四个顶层字段(均经实际调用确认):changes(本页变动记录)、shows(按作品 id 索引的受影响作品)、hasMore 和 nextCursor。每条变动记录包含 changeType、itemType、showId、showType、streamingOptionType、timestamp(Unix 秒)、link(指向平台内该作品的深度链接)和 service(id、name、homePage、themeColorCode、imageSet)。每个关联作品包含 id、itemType、showType、title、originalTitle、overview、releaseYear、runtime(分钟)、rating、imdbId、tmdbId、genres(id 和 name)、cast、directors、imageSet(竖版海报、横版海报以及多种宽度的横版背景图)和按国家代码索引的 streamingOptions;每个播放选项含 type、link、videoLink、audios、subtitles、availableSince、expiresSoon 以及提供该选项的 service。字段名来自一次实际探测(change_type=new、item_type=show、country=us、catalogs=netflix、show_type=movie),返回了 25 条变动且 hasMore 为 true;其他变动类型和条目类型来自接口文档说明,探测中没有实际调用。

API 功能

五种文档约定的变动类型 change_type 可选 new、removed、updated、expiring 或 upcoming,同一个接口既能追踪过去的版权进出,也能查看未来的即将下架和即将上线窗口。
31 天 from/to 时间窗口 from 和 to 是包含边界的 Unix 时间戳。历史类变动可取今天到 31 天前,未来类变动可取今天到 31 天后,省略时两端各有文档约定的默认值。
支持套餐类型与附加频道的平台选择器 catalogs 最多接受 32 个逗号分隔的选择器:单独的平台 id、service.subscription/free/rent/buy/addon,或 service.addon.<addon id>。省略则搜索该国家的全部片库。
未来变动的未知日期处理 include_unknown_dates 可把平台从未公布确切日期的即将到期和即将上线记录一并返回。这些记录按 timestamp 0 排序,升序时排在最前,降序时排在最后。
每页 25 条的游标分页 每页返回 25 条变动,并附带 hasMore 和 nextCursor。其余参数保持不变,把 URL 转义后的 nextCursor 作为 cursor 传回即可遍历完整结果集。

在线 API 演示

GET /api/project/streaming-availability/get-changes

调用成本暂不可用,未假定任何价格。

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/streaming-availability/get-changes?key=<API_KEY>&change_type=new&country=<country>&include_unknown_dates=False&item_type=show&output_language=en'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

文档里有哪些 change_type 取值?

文档列出五种:历史变动的 new、removed、updated,以及未来变动的 expiring、upcoming。使用 change_type=new 的实际探测返回了 25 条 changeType 为 new 的记录;其余四个取值有文档说明,但探测中没有实际调用。

from 和 to 最多能往前或往后取多久?

历史类变动(new、removed、updated)的两个时间戳都必须落在今天到 31 天前之间;未来类变动(expiring、upcoming)则必须落在今天到 31 天后之间。省略时,历史查询默认取 31 天前到今天,未来查询默认取今天到 31 天后。

include_unknown_dates 有什么作用?

对历史类变动没有影响,因为它们一定带有时间戳。对 expiring 和 upcoming 来说,它会把平台从未给出确切日期的变动也包含进来。这些记录按 timestamp 为 0 排序,所以升序时排在最前,降序时排在最后。

变动超过 25 条时如何翻页?

先看 hasMore。为 true 时,重复同一个请求,并把 cursor 设为上一次响应中的 nextCursor。cursor 需要先做 URL 转义,因为它可能包含 ? 和 &。首次请求不传 cursor。

catalogs 参数接受什么格式?

最多 32 个以逗号分隔的选择器。单独的平台 id(如 netflix)搜索该平台的整个片库;prime.subscription 或 peacock.free 只限定一种播放选项类型(subscription、free、rent、buy、addon);hulu.addon.hbo 只限定一个附加频道。作品只要出现在任一所列片库中就会被包含。省略该参数则搜索该国家的全部片库。有效的平台 id 和附加频道 id 可从国家目录中获取。

相关接口

相关指南

查看订阅方案 →