International Showtimes

Simple API for global cinema, showtimes, movies and VOD metadata.

原始信息汇总

International Showtimes API 数据集概述

数据集基本信息

• 数据集名称：International Showtimes
• 提供方：International Showtimes
• 访问方式：API
• 费用：提供免费试用和订阅计划

核心数据内容与规模

• 每日场次数据：超过200万条实时更新的全球影院放映时间。
• 电影元数据：数据库包含超过168,000部电影，涵盖演员、剧组、评分、预告片和海报图像。
• 影院覆盖：覆盖25,000多家影院，遍布47个以上国家。
• 市场覆盖：涵盖全球120多个市场，覆盖所有大洲。

数据服务特性

• 数据更新：通过“自动聚合算法”提供最新、最准确的放映时间数据。
• 服务可靠性：企业级可靠性，保证99%的正常运行时间。
• ID匹配：匹配所有相关的电影ID（IMDB、TMDB、Rentrak、EIDR等）。
• 高级格式支持：提供“票务深度链接”和高级“放映时间格式”（户外、MX4D、D-BOX、索尼4K、HFR、4DX等）。

API 核心端点

1. 电影

• 列出电影：GET /movies
• 获取电影详情：GET /movies/{movie_id}

2. 影院

• 列出影院：GET /cinemas
• 获取影院详情：GET /cinemas/{cinema_id}

3. 放映时间

• 列出放映时间：GET /showtimes
• 获取放映时间详情：GET /showtimes/{id}

4. 城市

• 列出城市：GET /cities

5. 流派

• 列出电影流派：GET /genres

6. 属性

• 列出放映时间属性：GET /attributes（获取所有可用的放映时间属性，如3D、IMAX、杜比全景声等）

7. 国家与语言环境

• 列出国家：GET /countries
• 列出语言环境：GET /locales

8. 影院连锁

• 列出影院连锁：GET /chains

主要功能与用途

• 构建电影票预订平台。
• 构建影院查找应用程序。
• 构建电影发现应用程序。
• 构建娱乐指南。
• 构建放映时间聚合器。

支持的国家/地区（示例）

• 美国（US）
• 英国（GB）
• 德国（DE）
• 法国（FR）
• 西班牙（ES）
• 意大利（IT）
• 加拿大（CA）
• 澳大利亚（AU）

认证方式

• HTTP 头 X-Api-Key（推荐）
• 令牌访问认证：Authorization: Token token=YOUR_API_KEY
• URL 参数：apikey=YOUR_API_KEY（不推荐）

近期API更新

• 2025年9月：分页改进，所有列表端点现在返回分页结果。
• 2024年11月：新增movie_page_link字段，作为预订深度链接不可用时的替代方案。
• 2023年12月：年龄限制增强，为德国添加了英语/德语翻译的详细内容描述符。
• 2023年1月：属性过滤，添加了attribute_codes参数以按版本属性过滤放映时间。
• 2021年1月：增量更新，添加了changed_since参数以高效同步放映时间。

使用限制与最佳实践

• 分页：所有列表端点返回分页结果，默认page_size为100，最大为500。
• 缓存：建议缓存电影和影院数据响应以减少API调用。
• 过滤：始终按国家或城市过滤以获得更相关、更快速的结果。
• 本地化：使用lang参数获取用户语言的内容。
• 增量更新：在/showtimes端点上使用changed_since参数仅获取自上次请求以来的更新。
• API密钥安全：避免在URL参数中使用API密钥，建议使用X-Api-Key头。

错误处理

• 常见HTTP状态码：200（成功）、401（未授权）、404（未找到资源）、429（超出速率限制）、500（服务器错误）。
• 错误响应格式：包含error对象，其中有code、user_message和debug_message。

支持与资源

• 免费试用：获取7天免费访问权限。
• 完整订阅：https://internationalshowtimes.com/subscription
• 官方文档：https://api.internationalshowtimes.com/documentation/v5
• 支持：通过JIRA Service Desk报告问题并获取帮助。

搜集汇总

背景与挑战

背景概述

International Showtimes是一个全球影院、电影放映时间及视频点播元数据的简单API数据集。它专注于提供全球范围内的电影相关服务信息。