API de films et séries top IMDB

Les rankings les plus complets d’IMDb avec notre API. Tops et même pires notés, pour des insights complets.

🌟 Fonctionnalités principales

• Top 100 films : Les mieux notés aussitôt
• Top 100 séries : Le plus populaire
• Combinés : Tops unifiés
• Pires notés : Explorez les pires pour analyse totale
• Filtres futés : Recherche et pagination partout
• Aléatoire : Titres au hasard de toute catégorie

📚 Points de terminaison

Films top

• GET /v1/imdb/top/movies : Top 100
• GET /v1/imdb/top/movies/random : Film top au hasard

Séries top

• GET /v1/imdb/top/tv-shows : Top 100 séries
• GET /v1/imdb/top/tv-shows/random : Série top au hasard

Combinés

• GET /v1/imdb/top/titles : Tops combinés
• GET /v1/imdb/top/titles/random : Top au hasard

Pires

• GET /v1/imdb/worst/titles : Pires notés
• GET /v1/imdb/worst/titles/random : Un pire au hasard

📊 Données de réponse

Chaque titre avec métas IMDb :

• id : Identifiant IMDb
• title : Nom
• type : Catégorie
• genres : Genres
• averageRating : Note
• numVotes : Votes
• releaseYear : Année

🔍 Paramètres

Toute liste supporte :

• name : Filtre par nom
• page : Pagination (défaut : 1)

⚡ Status

• 200 : Ok
• 400 : Fautive
• 401 : Non autorisé
• 403 : Interdit
• 404 : Introuvable
• 500 : Interne

💡 Parfaite pour

• Critiques
• Sites divertissement
• Recos
• Analyse ciné
• Suivi séries
• Critique
• Analytics
• Curation