列出所有支持的国家及其流媒体平台

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

一次响应返回完整的覆盖范围目录:以 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 功能

一次响应返回全部 65 个国家 目录一次返回所有支持的国家,以两位国家代码为键,无需处理游标;每天对比一次返回内容,就能发现新增的国家。
可用于片库筛选的稳定平台 id 每个平台都带有 id,片库查询和变动查询可将它作为 catalogs 选择器,筛选值可以直接取自这个目录,不必维护硬编码列表。
按国家区分的播放类型标志 streamingOptionTypes 以布尔值标出订阅、免费、租赁、购买和附加频道,说明某个平台在特定国家实际提供哪些观看方式。
附加频道清单 每个平台的 addons 列出附加频道的 id、名称、官网和徽标,数量因平台和国家而异,从没有到一百多个不等。
浅色、深色和白色三种徽标 URL 每个平台和附加频道的 imageSet 提供 lightThemeImage、darkThemeImage、whiteImage 三种徽标 URL,并附带 themeColorCode,方便渲染平台选择器。

在线 API 演示

GET /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'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

目录一共返回多少个国家?

一次不带参数的实际探测返回了 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。

相关接口

相关指南

查看订阅方案 →