获取单个国家的流媒体平台、播放类型和附加频道

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

按路径参数 country-code 中的 ISO 3166-1 alpha-2 国家代码返回单个国家对象,包含 countryCode、name 和 services。使用 us 的实际探测返回了美国,共 20 个平台。每个平台包含 id、name、homePage、themeColorCode、imageSet(lightThemeImage、darkThemeImage、whiteImage 三种徽标 URL)、streamingOptionTypes 和 addons。streamingOptionTypes 是由 addon、buy、rent、free、subscription 五个布尔值组成的对象,可据此判断某个平台在该国家提供租赁、购买、免费套餐还是只有订阅。每个附加频道包含 id、name、homePage、themeColorCode 以及自己的 imageSet。在美国的抽样中,有六个平台带有附加频道,数量从一个到 140 个(Prime Video)不等。output_language(en、es、tr、fr)用于本地化返回的名称。如果已经知道国家,想拿到它的平台 id、播放类型和附加频道 id,用来在查询片库或变动之前校验 catalogs 选择器,就适合使用这个接口。上述字段名和数量均来自针对 us 的实际调用;接口文档也说明该响应列出该国家受支持的平台及其名称、徽标、支持的播放类型和可用的附加频道。

API 功能

按国家代码单独获取 在路径中传入 ISO 3166-1 alpha-2 国家代码,只返回该国家的条目,不必下载包含 65 个国家的完整目录。
每个平台的播放类型布尔值 streamingOptionTypes 分别标出 addon、buy、rent、free 和 subscription,界面可以据此隐藏当地不提供租赁或购买的平台的对应控件。
带独立徽标的附加频道 每个平台的 addons 数组列出频道 id、名称、官网、主题色和徽标,方便用正确的品牌标注「通过频道包含」的观看选项。
官网链接与跳转目标 每个平台和附加频道除了 id,还带有 homePage 网址,对比表格里既能放链接,也能保留其他查询所需的选择器值。
片库查询前先校验选择器 返回的平台 id 和附加频道 id 正是其他接口接受的 catalogs 选择器,因此未知的平台 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 应该填什么?

填写 ISO 3166-1 alpha-2 国家代码,例如 us。使用 country-code=us 的实际探测返回了美国对象,共 20 个平台。受支持的代码就是完整国家目录中的键。

它与完整的国家目录有什么区别?

目录接口一次返回全部受支持国家;这个接口针对单个代码返回结构相同的国家对象。在已经知道国家的情况下,获取和缓存的开销更小。

会返回多少个平台和附加频道?

因国家而异。美国的实际抽样有 20 个平台,其中六个带有附加频道,数量从一个到 Prime Video 的 140 个不等。目录抽样中的其他国家最少只有一个平台。

streamingOptionTypes 标志是什么意思?

这是一个对象,包含 addon、buy、rent、free 和 subscription 五个布尔值,说明该平台在这个国家提供哪些播放类型。它们对应片库选择器可接受的播放类型后缀。

返回的 id 可以直接用于其他查询吗?

可以。平台的 id 是有效的 catalogs 选择器,附加频道的 id 则扩展为 service.addon.<addon id>。先在这里确认,可以避免发送该国家不支持的选择器。

相关接口

相关指南

查看订阅方案 →