按平台、类型、年份与评分筛选流媒体片库

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

在一个必填的 country 国家范围内浏览可观看的电影和剧集。catalogs 最多接受 32 个逗号分隔的片库选择器：netflix 这类平台 ID、prime.subscription 这类平台加访问方式，或 service.addon.addon_id 这类平台加附加频道标识；服务和频道 ID 应取自该国家目录。只填平台 ID 会包含其支持的观看方式，不等于仅会员包含；多个选择器按任意一个匹配，省略 catalogs 则搜索该国所有可用片库。可用分类目录返回的 genres ID 组合筛选，通过 genres_relation 选择同时满足或任一满足，并叠加片名或简介关键词、原始语言、年份和评分范围。order_by 支持原始片名、发行日期、评分及列出的热度周期；高分优先可选择 rating 和 order_direction=desc。响应数据为含 shows、hasMore 和可能的 nextCursor 的对象。每个作品可带标识、年份、简介、分类、演员、评分、片长、图片及该国观看选项，后者可能还包含所选片库之外的平台。仅当 hasMore=true 时才用 nextCursor 续页，其他筛选条件全部保持不变。无匹配时可返回 shows=[]、hasMore=false 且不含 nextCursor。电影或作品级页面每页 20 项，剧集的页大小随详情层级而变化。这里只提供发现资料和服务链接，不返回可播放媒体。

API 功能

平台、访问方式与频道选择器 用整个平台、指定访问方式或具体附加频道筛选片库，避免把会员包含与额外付费混为一谈。
多维条件组合发现作品 将分类逻辑、片名或简介关键词、原始语言、年份上下限和评分范围应用到同一次查询。
评分及分周期热度排序 选择支持的 order_by 和排序方向，构建高分优先或不同热度周期的发现列表。
游标续页与明确的空片库状态 读取 shows 和 hasMore，仅在还有更多结果时传回 nextCursor；无匹配时无需强求游标字段。

在线 API 演示

GET /api/project/streaming-availability/search-shows-by-filters

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

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/streaming-availability/search-shows-by-filters?key=<API_KEY>&country=<country>&genres_relation=and&order_by=original_title&output_language=en&series_granularity=show'
📢
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
联系我们

使用场景

常见问题

如何查询 Netflix 美国区电影片库？

将 country 设为 us、catalogs 设为 netflix、show_type 设为 movie，再按需叠加分类、年份或评分筛选。解析响应数据中的 shows，并仅在 hasMore=true 时使用 nextCursor 请求后续页。结果以当次数据为准。

怎样只筛选会员可看内容，排除租赁和购买？

先查目标国家的平台目录，确认服务 ID 和支持的访问方式，再使用 service.subscription 形式，例如 prime.subscription。裸平台 ID 不代表会员专享；展示结果时仍应逐项检查观看选项的 type、价格及附加频道要求。

游标分页时可以修改年份或平台条件吗？

不能把旧游标与新条件混用。续页时除 cursor 外的国家、片库、分类、排序等参数都应保持一致；修改筛选条件后应去掉旧 cursor，从第一页重新开始。hasMore=false 时停止。

筛选一个平台后，为什么作品还带其他平台的链接？

catalogs 决定哪些作品符合查询条件，不保证把每部作品的 streamingOptions 裁剪为单个平台。展示时应按实际返回的服务与访问方式处理；若界面只想显示选中平台的入口，可在展示层再筛选对应选项。

相关接口

相关指南

查看订阅方案 →