+ Endpoints
+
+
+
+ GET
+ /api?t=movie&q=<tmdb_id>
+
+ Retourne le détail TMDB complet d'un film + note IMDb fusionnée.
+ Paramètres
+
+ | Param | Type | Requis | Description |
|---|
+ t | string | oui | Doit être movie |
+ q | integer | oui | ID TMDB du film |
+
+ Exemple
+ curl 'https://tmdb.uklm.xyz/api?t=movie&q=27205'
+ Réponse (extrait)
+ {
+ "id": 27205,
+ "title": "Inception",
+ "original_title": "Inception",
+ "imdb_id": "tt1375666",
+ "release_date": "2010-07-15",
+ "runtime": 148,
+ "vote_average": 8.4,
+ "vote_count": 39044,
+ "note_imdb": "8.8",
+ "vote_imdb": "2809792",
+ "budget": 160000000,
+ "revenue": 839030630,
+ "tagline": "Votre esprit abrite la scène du crime.",
+ "overview": "Dom Cobb est un voleur expérimenté…",
+ "genres": [{"id": 28, "name": "Action"}, …],
+ "production_countries": [{"iso_3166_1": "US", …}],
+ "poster_path": "/aej3LRUga5rhgkmRP6XMFw3ejbl.jpg",
+ "external_ids": {…},
+ "credits": {…},
+ "images": {…},
+ "videos": {…},
+ "translations": {…}
+}
+ Le format complet correspond à l'objet TMDB /movie/{id}?append_to_response=credits,external_ids,release_dates,translations,images,videos avec note_imdb et vote_imdb ajoutés.
+
+
+
+
+ GET
+ /api?t=tv&q=<tmdb_id>
+
+ Idem pour les séries. imdb_id est dans external_ids.imdb_id pour les séries.
+ Exemple
+ curl 'https://tmdb.uklm.xyz/api?t=tv&q=1408'
+ Champs supplémentaires propres aux séries : seasons, aggregate_credits, first_air_date, last_air_date, name, original_name.
+
+
+
+
+ GET
+ /api?t=imdb&q=<imdb_id>
+
+ Lookup direct par IMDb ID. Renvoie le détail movie ou tv correspondant. Tente movie d'abord, puis tv.
+ Paramètres
+
+ | Param | Type | Requis | Description |
|---|
+ t | string | oui | Doit être imdb |
+ q | string | oui | IMDb ID au format tt0133093 |
+
+ Exemple
+ curl 'https://tmdb.uklm.xyz/api?t=imdb&q=tt0133093'
+# → renvoie l'objet complet de Matrix (TMDB 603)
+ Si non trouvé
+ {"error": "IMDb id not found in local mappings"}
+
+
+
+
+ GET
+ /api?t=providers&type=<movie|tv>&q=<tmdb_id>
+
+ Watch providers JustWatch par pays (FR, US, GB, etc.) — données du endpoint TMDB /watch/providers.
+ Paramètres
+
+ | Param | Type | Requis | Description |
|---|
+ t | string | oui | Doit être providers |
+ type | string | oui | movie ou tv |
+ q | integer | oui | ID TMDB |
+
+ Exemple
+ curl 'https://tmdb.uklm.xyz/api?t=providers&type=movie&q=603'
+ Réponse
+ {
+ "id": 603,
+ "results": {
+ "FR": {
+ "link": "https://www.themoviedb.org/movie/603/watch?locale=FR",
+ "flatrate": [
+ {"provider_id": 8, "provider_name": "Netflix", "logo_path": "/…"},
+ …
+ ],
+ "rent": [...],
+ "buy": [...]
+ },
+ "US": {…},
+ …
+ }
+}
+ Catégories possibles par pays : flatrate (abonnement), rent, buy, free, ads.
+
+
+
+
+ GET
+ /api?t=search&q=<requête>
+
+ Recherche par titre + année + épisode. Parsing intelligent de la requête :
+
+ - Année extraite via regex
(19|20)\d{2} en excluant 1080 et 2160
+ - Épisode reconnu :
SxxExx, Sxx, partN, NxN, Exxx
+ - Présence d'un épisode → bascule en mode
tv, sinon movie
+ - Distance Levenshtein UTF-8 sur titres FR / EN / VO, tri par score → popularité → écart d'année
+
+ Exemples
+ curl 'https://tmdb.uklm.xyz/api?t=search&q=Inception%202010'
+curl 'https://tmdb.uklm.xyz/api?t=search&q=Mr.Robot.S01E02'
+curl 'https://tmdb.uklm.xyz/api?t=search&q=Coeur%20de%20Pirate%202019'
+ Réponse
+ {
+ "results": [
+ {
+ "title": "Inception",
+ "english_title": "Inception",
+ "original_title": "Inception",
+ "years": 2010,
+ "poster": "https://image.tmdb.org/t/p/w200/aej3LRUga5rhgkmRP6XMFw3ejbl.jpg",
+ "poster_path": "/aej3LRUga5rhgkmRP6XMFw3ejbl.jpg",
+ "genres": "Action Science-Fiction Aventure ",
+ "countries": "GB US ",
+ "runtime": "2 h 28 min",
+ "imdb_id": "tt1375666",
+ "imdb_url": "https://www.imdb.com/title/tt1375666",
+ "note_imdb": 8.8,
+ "vote_imdb": 2809792,
+ "tmdb_id": 27205,
+ "tmdb_url": "https://www.themoviedb.org/movie/27205",
+ "api_url": "https://tmdb.uklm.xyz/api?t=movie&q=27205",
+ "note_tmdb": 8.4,
+ "vote_tmdb": 39044,
+ "budget": "$160,000,000",
+ "revenue": "$839,030,630",
+ "tagline": "Votre esprit abrite la scène du crime.",
+ "overview": "Dom Cobb…"
+ },
+ …
+ ]
+}
+ Réponses cachées en mémoire (LRU 1000 entrées, TTL 1 h). Premier appel ~1 s, suivants ~10 ms.
+
+
+
+
+ GET
+ /search?query=<requête>
+
+ Même recherche, mais rendue en HTML (vignettes posters + panneaux d'info inline). Compat avec l'ancien search.php.
+ curl 'https://tmdb.uklm.xyz/search?query=Inception%202010'
+
+
+
+
+ Liveness/readiness JSON. 200 si l'index IMDb est chargé, 503 sinon.
+ {
+ "status": "ok",
+ "uptime": 86400,
+ "pid": 12345,
+ "node": "v22.18.0",
+ "memory_mb": 943,
+ "imdb_ratings": 1664245
+}
+ Exempté du rate limit.
+
+
+
+
+ Format Prometheus standard. Métriques exposées :
+
+ http_requests_total{method, route, status} — counterhttp_request_duration_seconds{method, route, status} — histogramsearch_cache_hits_total, search_cache_misses_totalimdb_ratings_total, search_workers{type}- Métriques process Node par défaut (CPU, RSS, heap, event loop lag, GC)
+
+ Vue humaine disponible sur /admin (onglet Métriques). Exempté du rate limit.
+
+
+
+