查询某国家新上线、已下架、已更新、即将到期和即将上线的影视片库变动
查看 流媒体观看平台与片库查询 的全部接口 →按国家返回流媒体片库的变动记录,每页 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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=expiring 记录时,发送即将下架提醒。
- 轮询 change_type=new 并设置 catalogs=netflix、show_type=movie,为某个国家生成每日「Netflix 新片上线」摘要。
- 基于 change_type=new 和 change_type=removed 的分页数据,统计各平台每日新增与下架数量,搭建版权流动看板。
- 规划上线内容日历时设置 include_unknown_dates=true,让尚未确认日期的作品也能出现在日历里。
常见问题
文档里有哪些 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 可从国家目录中获取。