API de filmes e séries top do IMDB

API de filmes e séries top do IMDB

Os rankings mais completos do IMDb com nossa API. Tops e até os piores avaliados para insights completos.

🌟 Principais recursos

  • Top 100 filmes: Os mais bem avaliados na hora
  • Top 100 séries: O conteúdo mais popular
  • Combinados: Tops unificados
  • Piores avaliados: Explore os piores para análise total
  • Filtros espertos: Busca e paginação em tudo
  • Aleatório: Títulos aleatórios de qualquer categoria

📚 Endpoints da API

Filmes top

  • GET /v1/imdb/top/movies: Top 100
  • GET /v1/imdb/top/movies/random: Filme top aleatório

Séries top

  • GET /v1/imdb/top/tv-shows: Top 100 séries
  • GET /v1/imdb/top/tv-shows/random: Série top aleatória

Combinados

  • GET /v1/imdb/top/titles: Tops combinados
  • GET /v1/imdb/top/titles/random: Título top aleatório

Piores

  • GET /v1/imdb/worst/titles: Piores avaliados
  • GET /v1/imdb/worst/titles/random: Um pior aleatório

📊 Dados de resposta

Cada título com metadados IMDb:

  • id: Identificador IMDb
  • title: Nome
  • type: Categoria
  • genres: Gêneros
  • averageRating: Nota
  • numVotes: Votos
  • releaseYear: Ano

🔍 Parâmetros

Toda lista suporta:

  • name: Filtra por nome
  • page: Paginação (padrão: 1)

⚡ Status

  • 200: Ok
  • 400: Inválida
  • 401: Não autorizado
  • 403: Proibido
  • 404: Não encontrado
  • 500: Erro interno

💡 Perfeita para

  • Reviews
  • Sites de entretenimento
  • Recomendações
  • Análise de cinema
  • Acompanhar séries
  • Crítica
  • Analytics
  • Curadoria