API de películas y series top de IMDB

Accede a los datos de ranking más completos de IMDb con nuestra potente API. Películas y series top, e incluso los títulos peor valorados, para un análisis completo del entretenimiento.

🌟 Características principales

Top 100 películas: Las películas mejor valoradas de IMDb al instante
Top 100 series: El contenido televisivo más popular
Rankings combinados: Top de películas y series en un solo acceso
Peor valorados: Explora los títulos peor valorados para un análisis completo
Filtrado inteligente: Búsqueda por título y paginación en todos los endpoints
Selección aleatoria: Títulos aleatorios de cualquier categoría

📚 Endpoints de la API

Películas top

GET /v1/imdb/top/movies: La lista top 100 de IMDb
GET /v1/imdb/top/movies/random: Una película top aleatoria

Series top

GET /v1/imdb/top/tv-shows: Las 100 mejores series
GET /v1/imdb/top/tv-shows/random: Una serie top aleatoria

Rankings combinados

GET /v1/imdb/top/titles: Películas y series top combinadas
GET /v1/imdb/top/titles/random: Un título top aleatorio

Peor valorados

GET /v1/imdb/worst/titles: Los títulos peor valorados
GET /v1/imdb/worst/titles/random: Un título aleatorio de los peor valorados

📊 Datos de respuesta

Cada título incluye metadatos esenciales de IMDb:

id: Identificador único IMDb
title: Nombre de la película o serie
type: Categoría de contenido
genres: Lista de géneros
averageRating: Puntuación IMDb
numVotes: Número de votos
releaseYear: Año de estreno

🔍 Parámetros de consulta

Todos los endpoints de lista soportan:

name: Filtra resultados por nombre
page: Paginación (por defecto: 1)

⚡ Códigos de estado

200: Petición exitosa
400: Petición incorrecta
401: No autorizado
403: Prohibido
404: No encontrado
500: Error interno

💡 Perfecta para

Plataformas de reseñas
Webs de entretenimiento
Sistemas de recomendación
Herramientas de análisis de cine
Apps de seguimiento de series
Plataformas de crítica
Analítica de datos de entretenimiento
Servicios de curación de contenido