跟踪流媒体片库新增、移除与即将上下架
查看 影视观看平台与流媒体片库查询 的全部接口 →按必填 country、change_type 和 item_type 轮询片库变动。change_type 可选 new（新增）、removed（移除）、updated（更新）、expiring（即将到期）或 upcoming（即将上架）；item_type 可选 show、season、episode。show_type 用于将作品级变动进一步限定为电影或剧集。可选 catalogs 沿用片库搜索的 service、service.access_type 和 service.addon.addon_id 语法，最多 32 个逗号分隔选择器。响应数据含 changes 数组、以影视 ID 为键的 shows 映射、hasMore 及可能的 nextCursor；每条变动可含 changeType、itemType、showId、showType、streamingOptionType、service、link、timestamp，应通过 showId 关联 shows 中的作品资料。每页最多 25 条，按时间戳排序，order_direction 控制升降序。from 和 to 使用含边界的 Unix 秒级时间戳：new、removed、updated 限于过去 31 天，expiring、upcoming 限于未来 31 天，省略边界时覆盖对应规定窗口。未来条目的日期可能未知，include_unknown_dates 决定是否包含这些条目，不影响过去变动。仅在 hasMore=true 时传回 nextCursor，其他参数保持不变。这是轮询式变动查询，不是推送通知或无限期历史档案，也不保证每个平台都有未来日期数据。
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>&country=<country>&include_unknown_dates=false&output_language=en'
查询结果
使用场景
- 定时查询 Netflix 新增记录并关联作品简介与服务链接，生成新片上架订阅简报。
- 结合新增、移除和更新记录维护本地可用性索引，并自行保存快照以保留窗口之外的历史。
- 为提供到期信息的平台开发观影清单下架提醒，明确区分已确认截止时间与未知日期。
- 按国家、片库和条目层级生成未来上架摘要，续页时保持时间范围与其他条件一致。
常见问题
怎样开发 Netflix 新片上架通知或即将下架提醒？
由你的应用定时轮询变动接口，指定 country、catalogs、change_type 和 item_type。新增片单用 new，即将到期提醒用 expiring；再按 showId 关联 shows 获取标题资料。该接口本身不是推送通知，未来日期是否可用取决于返回数据。
能查询几年前的片库上下架历史吗？
不能将本接口当作无限期历史档案。new、removed、updated 查询范围为过去 31 天，expiring、upcoming 为未来 31 天；from、to 使用 Unix 秒级时间戳且包含边界。更长期历史需要应用自行持续保存快照和变动。
changes 与 shows 应该怎样关联？
changes 是变动数组，shows 是以影视 ID 为键的对象映射。读取每条记录的 showId，再从 shows 中按键查找资料，不要按数组位置配对。只有 hasMore=true 时才继续传回 nextCursor，并保持其余参数不变。
include_unknown_dates 能补全没有日期的上架信息吗？
不能。它只决定是否包含未来变动中日期未知的条目，不会生成缺失日期，也不影响过去变动。未知时间在升序中排在已知时间前、降序中排在后，应标为日期待定，不能显示成确定的提醒截止日。