Streaming Services Top Shows API

🎬 Top Shows API

Get **Top 10 and trending movies & TV shows** from major streaming platforms worldwide.
Includes **official Netflix Top 10 data** and popular titles from 30+ streaming services across 100+ countries.

原始信息汇总

Streaming Services Top Shows API 数据集概述

基本信息

• API名称：Streaming Services Top Shows API
• API提供商：halearn
• 类别：Movies
• 基础URL：https://streaming-services-top-shows-api.p.rapidapi.com
• 认证方式：通过RapidAPI自动注入X-RapidAPI-Key和X-RapidAPI-Host头部，无需额外认证。

核心功能

• 提供全球主要流媒体平台的Top 10和热门电影与电视节目。
• 包含官方的Netflix Top 10数据（按国家划分）。
• 通过JustWatch获取热门和流行内容。
• 支持30+个流媒体服务和100+个国家。
• 涵盖电影和电视剧系列。
• 提供IMDB ID和元数据增强。
• 采用智能缓存实现快速响应。
• 提供简单的REST API。

支持的流媒体服务（部分列表）

Netflix, Netflix Kids, HBO Max, Disney+, Prime Video, Apple TV+, Hulu, Paramount+, Peacock, Crunchyroll, Starz, Discovery+, Mubi, Rakuten Viki, Sony Liv, Zee5, JioHotstar, Globoplay, Canal+, SkyShowtime, Curiosity Stream, MagellanTV, NLZIET等。

端点

1. GET /top-shows

• 描述：返回特定国家在特定流媒体服务上的热门电影或电视节目。
• 必需查询参数：
  • service：流媒体服务代码（例如nfx, hbm, dnp）。
  • country：ISO国家代码（例如US, GB, FR）。
• 可选查询参数：
  • type：movie或series（仅限非Netflix服务）。
• 示例请求：
  • GET /top-shows?service=nfx&country=US
  • GET /top-shows?service=dnp&country=BR&type=movie

2. GET /services

• 描述：返回所有支持的流媒体平台列表。

3. GET /countries

• 描述：返回支持的国家列表。
• 可选查询参数：service（按服务筛选，例如service=nfx）。

4. GET /health

• 描述：健康检查端点。

数据结构示例

节目对象

json { "rank": 1, "title": "Movie or Show Title", "type": "movie | series", "imageUrl": "string", "poster": "string", "imdbId": "tt1234567", "releaseYear": 2023, "description": "Optional description" }

错误格式

json { "success": false, "error": "Error message" }

常见服务代码示例

• nfx – Netflix
• nfk – Netflix Kids
• hbm – HBO Max
• dnp – Disney+
• amp – Prime Video
• atp – Apple TV+
• hlu – Hulu
• cru – Crunchyroll

速率限制

• /top-shows端点：每15分钟30次请求。
• 其他端点：每15分钟100次请求。
• 响应中包含速率限制头部：RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset。

缓存策略

• Netflix Top 10数据缓存24小时。
• 元数据缓存7天。
• 重复请求响应更快。

错误代码

• 400 – 参数无效
• 404 – 未找到数据
• 429 – 超出速率限制
• 500 – 服务器错误

使用案例

• 流媒体内容发现应用
• 推荐引擎
• 娱乐仪表板
• 基于国家的流行度跟踪
• 媒体分析平台