International Showtimes Streaming API

Global streaming availability data for movies and TV shows

原始信息汇总

International Showtimes Streaming API 数据集概述

数据集名称

International Showtimes Streaming API (ScreenSights Streaming Availability API)

数据集概述

提供全球电影和电视节目的流媒体可用性数据，涵盖Netflix、Amazon Prime Video、Disney+、HBO Max等数百个平台。

关键特性

• 全球平台覆盖：覆盖100多个流媒体服务。
• 多国家支持：覆盖全球50多个国家。
• 全面筛选：支持按类型、平台、人物、年龄分级进行搜索。
• 外部ID支持：支持IMDB、TMDB、JustWatch集成。
• 丰富元数据：包含完整的演员、工作人员和内容信息。
• 多语言：内容支持多种语言（ISO 639-1）。
• 实时更新：可用性数据持续更新。
• 高性能：每页最多可返回10,000条结果。

核心端点

1. 按ID获取内容

• 端点：GET /api/v1/content/{id}
• 描述：检索特定电影或节目的详细信息。
• 路径参数：id（数字，必需）- 内容ID。
• 查询参数：apikey（字符串）- API密钥；language（字符串）- ISO 639-1语言代码。

2. 使用筛选器列出内容

• 端点：GET /api/v1/content
• 描述：使用强大的筛选选项检索电影和节目的分页列表。
• 必需查询参数：country（字符串）- ISO 3166-1 alpha-2国家代码。
• 其他查询参数：page、limit、language、search、platforms、content_type、genres、people、external_ids、age_certifications。

3. 搜索人物

• 端点：GET /api/v1/person
• 描述：搜索演员、导演和其他娱乐行业人物。
• 查询参数：apikey、page、limit、search。

4. 列出类型

• 端点：GET /api/v1/genre
• 描述：获取所有可用的内容类型。
• 查询参数：apikey、page、limit、language、content_type。

5. 列出流媒体平台

• 端点：GET /api/v1/platform
• 描述：获取特定国家/地区可用的所有流媒体平台。
• 必需查询参数：country（字符串）- ISO 3166-1 alpha-2国家代码。
• 其他查询参数：apikey、page、limit、content_type。

6. 列出国家

• 端点：GET /api/v1/country
• 描述：获取API支持的所有国家。
• 查询参数：apikey、page、limit。

7. 列出语言

• 端点：GET /api/v1/language
• 描述：获取API支持的所有语言。
• 查询参数：apikey、page、limit。

支持的国家

覆盖50多个国家，包括美国（US）、英国（GB）、加拿大（CA）、德国（DE）、法国（FR）、西班牙（ES）、意大利（IT）、澳大利亚（AU）、日本（JP）等。

支持的平台

覆盖100多个流媒体服务，包括Netflix、Amazon Prime Video、Disney+、HBO Max / Max、Hulu、Apple TV+、Paramount+、Peacock、Discovery+等。

定价

• 免费试用：7天0欧元 - 完全API访问。
• 基础版：每个市场每月149欧元起。
• 商业版：每个市场每月299欧元起。
• 企业版：自定义定价 - 联系销售。

速率限制

速率限制取决于订阅层级：

• 标准版：API速率限制按计划应用。
• 专用服务器：高达每小时20,000个请求。

错误处理

常见HTTP状态码：

• 200：成功。
• 400：错误请求 - 检查参数。
• 401：未授权 - API密钥无效。
• 404：资源未找到。
• 429：超出速率限制。
• 500：服务器错误。

最佳实践

1. 始终指定国家：country参数是大多数搜索所必需的。
2. 明智使用分页：默认限制为10，每次请求最大为10,000。
3. 缓存响应：内容可用性变化缓慢，缓存6-24小时。
4. 组合筛选器：使用多个筛选器（类型、平台、人物）以获得精确结果。
5. 外部ID查找：使用IMDB/TMDB ID进行精确匹配。
6. 语言本地化：始终指定language以获取本地化内容。
7. 平台ID：首先从/api/v1/platform端点获取平台ID。

支持

• 技术支持：JIRA Service Desk。
• 销售咨询：联系销售。
• 文档：API文档。

常见问题解答

• 与Showtimes API的区别：Showtimes API提供影院放映时间和剧院信息。此Streaming API提供VOD/流媒体可用性数据。
• 数据更新频率：流媒体可用性数据在平台添加或删除内容时实时持续更新。
• 是否支持按IMDB或TMDB ID搜索：支持。使用external_ids参数。
• 每次请求的最大限制：使用limit参数每页最多可请求10,000个项目。
• 是否支持所有流媒体平台：覆盖100多个主要平台。
• 是否可以按多个条件筛选：支持。可以组合筛选器。
• 内容是否本地化：支持。使用language参数获取本地化标题和元数据。

搜集汇总

背景与挑战

背景概述

该数据集通过API提供全球范围内电影和电视节目的流媒体播放信息。