列出所有支持的国家及其流媒体平台
查看 流媒体观看平台与片库查询 的全部接口 →一次响应返回完整的覆盖范围目录:以 ISO 3166-1 alpha-2 国家代码为键的对象,没有分页参数。一次不带任何参数的实际探测返回了 65 个国家。每个国家对象包含 countryCode、name 和 services。每个平台包含 id(其他接口可将它作为 catalogs 选择器使用)、name、homePage、themeColorCode、imageSet(lightThemeImage、darkThemeImage、whiteImage 三种徽标 URL)、streamingOptionTypes 和 addons。streamingOptionTypes 是由 addon、buy、rent、free、subscription 五个布尔值组成的对象,记录该平台在该国家实际提供哪些播放方式。每个附加频道包含 id、name、homePage、themeColorCode 以及自己的 imageSet;附加频道数量因平台和国家差异很大(实际抽样中从没有到一百多个不等)。output_language(en、es、tr、fr)用于本地化返回的名称。这些平台 id 和附加频道 id 正是片库查询与变动查询可用的 catalogs 选择器,因此先查询这个目录,才能保证筛选条件有效。上述国家集合、字段名和各国平台数量均来自实际调用;接口文档也说明该目录列出受支持的平台及其名称、徽标、支持的播放类型和可用的附加频道。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/streaming-availability/get-countries API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/streaming-availability/get-countries?key=<API_KEY>&output_language=en'
查询结果
使用场景
- 用实时返回的国家列表填充地区选择器,不必再自己维护一份受支持市场的硬编码清单。
- 整理各平台在各国家的上线情况,制作市场研究报告里的覆盖矩阵。
- 每天对比目录内容,发现新增支持的国家,或某个平台在某个市场的上线与退出。
- 在本地缓存平台 id,使片库查询和变动查询只发送该国家确实存在的 catalogs 选择器。
常见问题
目录一共返回多少个国家?
一次不带参数的实际探测返回了 65 个国家,以 ISO 3166-1 alpha-2 代码为键,从 ae 到 za。响应是单个对象,不分页。
每个国家条目包含哪些内容?
包含 countryCode、name 和 services。每个平台有 id、name、homePage、themeColorCode、由三个徽标 URL(lightThemeImage、darkThemeImage、whiteImage)组成的 imageSet、streamingOptionTypes 对象和 addons 数组。
如何知道某个平台在某国提供哪些播放类型?
读取该平台的 streamingOptionTypes 对象,其中包含 addon、buy、rent、free、subscription 五个布尔值。例如在美国的抽样中,Netflix 只有 subscription 为 true。
片库筛选用的值从哪里获取?
平台的 id 字段就是片库查询和变动查询接受的 catalogs 选择器,附加频道的 id 则扩展为 service.addon.<addon id>。先获取这个目录,就能保证各国家的选择器有效。
output_language 会改变数据结构吗?
不会。它只本地化返回的文本,例如国家名称和平台名称。可选代码为 en、es、tr、fr,默认值为 en。