查询一个国家的流媒体平台与附加频道

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

将支持的小写国家代码填入必填路径参数 country-code，例如 us，获取该地区的平台目录。output_language 支持 en、es、tr、fr，默认英语。响应数据是单个含 countryCode、name 和 services 的对象；服务条目可包含 id、name、homePage、themeColorCode、imageSet、带布尔标志的 streamingOptionTypes，以及 addons 数组。附加频道条目可带 id、name、homePage、themeColorCode 和 imageSet。使用该国家返回的平台与频道 ID，可构造 service.subscription 或 service.addon.addon_id 这样的片库选择器。addons 为空数组时，只表示此次响应没有为该服务列出频道。平台支持某种访问方式是目录能力，不证明某部电影或电视剧当前可看；具体观看入口必须通过作品自己的 streamingOptions 确认。

API 功能

聚焦单一市场的目录对象 只获取选中国家的 countryCode、名称与 services，无需下载整个支持国家目录。
平台能力采用布尔标志 依据 streamingOptionTypes 的访问方式标志，决定该服务应提供哪些筛选选项。
地区专属附加频道标识 发现当前国家各服务下列出的 addons，并用频道 ID 组成完整的片库选择器。
平台设置页所需显示素材 使用服务名称、主页、主题色和图片资料，制作当地平台选择与配置界面。

在线 API 演示

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

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

只查询美国支持的平台，应传哪个国家参数？

本接口使用路径参数 country-code，传入 us；它与其他接口的 country 查询参数名称不同。国家代码应从支持国家目录获取，响应数据为这个国家的单个目录对象。

怎样找到附加频道 ID 并构造片库筛选值？

先在 services 中确认母平台 id，再查看其 addons 数组中的频道 id，按 service.addon.addon_id 形式组合。不要用频道显示名称替代 ID，也不要沿用未经确认的其他国家频道标识。

addons 是空数组，是否意味着该平台没有电影？

不是。空数组只说明当前响应未为该服务列出附加频道，不反映影片数量或具体作品是否可看。影片片库用筛选搜索查询，单部作品的观看状态用其 streamingOptions 判断。

平台目录里的 homePage 是电影播放链接吗？

不是。homePage 是服务或频道主页，imageSet 和 themeColorCode 用于展示。要取得某部作品的服务页面链接，应先查询作品并读取对应观看选项中的 link，实际播放仍需符合平台的账号、付费及地区要求。

相关接口

相关指南

查看订阅方案 →