获取电影与电视剧的分类筛选 ID
查看 影视观看平台与流媒体片库查询 的全部接口 →获取受支持的影视分类目录，output_language 可选 en、es、tr、fr。响应数据直接是包含 id 和 name 的对象数组，不分页，也没有额外 genres 字段。分类可包括 action、comedy、drama、scifi 等；请以返回目录为准，不固定假设分类总数。将 id 以逗号分隔填入片库搜索的 genres 参数，name 用于显示，不要将翻译后的分类名称作为筛选值。此接口仅返回分类参考，不含匹配作品、热度排名或各类片库数量。中文界面可以自行维护显示标签，但中文不是 output_language 已列出的输出选项。
API 功能
分类筛选值与显示名称分离 把 id 保存为请求参数值，把 name 用于界面标签，避免翻译影响查询。
轻量分类键值对数组 直接读取顶层 id/name 对象数组，无需处理作品详情、平台目录或分页游标。
发现实际支持的影视类型 依据目录选择动作、喜剧、剧情、科幻等分类，不凭显示名称自行猜测可接受的标识。
四种已列明的分类标签语言 可请求英语、西班牙语、土耳其语或法语名称，查询片库时仍使用返回的分类 ID。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
GET
/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'
curl -X GET 'https://api.opendata-api.com/api/project/streaming-availability/get-genres?key=<API_KEY>&output_language=en'
查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 为影视发现页生成分类筛选标签，将选中的 ID 提交到片库搜索的 genres 字段。
- 维护独立中文显示标签与接口分类标识的映射表，让本地化界面不改变请求语义。
- 校验已保存的分类推荐规则，对当前目录不再列出的 ID 提示重新选择。
- 根据受支持分类生成影视站点导航链接，而不是把显示名称直接拼成未经确认的筛选标识。
常见问题
片库搜索里的 genres 应该填中文分类还是英文名称？
应填写本接口返回的 id，例如 drama、comedy 等，并按需要用逗号分隔。name 是显示名称，不能把中文标签或翻译后的名称直接当作筛选值。多个分类的关系由片库搜索的 genres_relation 控制。
可以用 output_language=zh 获取中文分类名称吗？
已列出的输出选项只有 en、es、tr 和 fr，没有 zh。中文界面可以另外维护标签翻译，但应保留返回的分类 ID 作为请求值，也不能据此承诺影视简介支持中文输出。
分类接口会返回每个类型下的电影数量吗？
不会。它只返回分类 id 与 name，不含匹配作品、热度榜或片库计数。要查某个分类的作品，应将其 ID 传给片库筛选搜索，并指定国家及其他需要的条件。
分类列表需要翻页，或读取 genres 外层字段吗？
都不需要。响应数据直接是分类对象数组，没有分页游标或额外 genres 包装。按数组遍历 id 与 name 即可，分类覆盖和数量应以当前响应为准。