获取流媒体影视类型列表,含类型 id 与多语言名称
查看 流媒体观看平台与片库查询 的全部接口 →返回用于划分电影和剧集的完整类型列表,响应是一个纯 JSON 数组,每个元素包含字符串 id 和展示名称 name。唯一的输入是可选的查询参数 output_language(en、es、tr 或 fr,默认 en),用来指定输出语言。一次使用默认参数的示例调用返回 HTTP 200,根节点是包含 21 个条目的数组,每个条目只有 id(例如 scifi、thriller)和 name(例如 Science Fiction、Thriller)两个字段,没有外层对象,也没有游标或分页字段。这里返回的 id 正是按条件搜索片库接口 genres 参数可接受的取值,因此这份列表就是类型筛选的词表。示例调用只使用了默认语言,所以 es、tr、fr 的翻译名称虽有文档说明,但没有在示例中验证。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/streaming-availability/get-genres API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/streaming-availability/get-genres?key=<API_KEY>&output_language=en'
查询结果
使用场景
- 用实时返回的 id 填充类型下拉框或标签栏,而不是在应用里写死类型名称
- 每天缓存一次类型字典,并把作品记录中出现的类型 id 翻译成界面标签
- 通过 output_language 在多语言界面中显示西班牙语、土耳其语或法语的类型名称
- 在发起按类型筛选的片库搜索之前,先校验用户提交的类型标识是否有效
- 搭建心情选片器,把每种心情映射成一组类型 id,作为推荐筛选条件
常见问题
类型接口返回什么内容?
响应根节点是一个 JSON 数组,每个元素都有字符串 id 和字符串 name。在示例调用中,全部 21 个条目都只有这两个字段,例如 id 为 scifi、name 为 Science Fiction。
必须传参数吗?
不需要。唯一的参数是 output_language,它是可选的,支持 en、es、tr、fr,默认值为 en。
这些 id 怎么用在片库搜索里?
把一个或多个 id 用逗号拼接后传给按条件搜索片库接口的 genres 参数,例如 scifi,thriller;再用 genres_relation 指定必须同时满足全部类型(and)还是满足其中至少一个(or)。
修改 output_language 后类型名称会被翻译吗?
文档说明该参数用于设置输出语言,但示例调用只使用了默认的英语,所以翻译后的名称没有得到验证。建议以 id 而不是 name 作为你自己数据的键。
这个接口会分页吗?
不会。示例调用在一个数组里返回了完整列表,没有 cursor、hasMore 或 nextCursor 字段,一次请求就够了。
类型列表应该多久刷新一次?
来源文档没有说明列表的变化频率。由于它只是一张很短的参考表,在应用启动时或每天拉取一次并缓存,是比较合理的做法。