====== API AlloCiné v3 ======

Un nouveau système de signature des appels a été mis en place.

Un exemple d'utilisation en PHP est dispo sur mon GitHub : https://github.com/gromez/allocine-api.

===== Informations ===== [[http://www.allocine.fr|AlloCiné]] a mis à jour il y a quelques temps ses APIs.\\ Je vais tenter de les expliquer sur cette nouvelle page. Pour les découvrir, j'ai utilisé le même principe que [[allocine|la première fois]]. Une petite différence est à noter, il semblerait que la valeur ''partner'' a changé depuis. Sa valeur sera désormais ''QUNXZWItQWxsb0Npbuk''. L'URL de base a, elle aussi, changé : ''%%http://api.allocine.fr/rest/v3/%%'' ===== Les APIs ===== Les différentes APIs s'appellent toutes en ''GET''. Je n'ai pas testé en ''POST'' mais si c'est comme avant, ça ne devrait pas marcher. ==== Recherche : search ==== * URL : ''http://api.allocine.fr/rest/v3/search'' * Paramètres * ''partner'' : code partenaire (''QUNXZWItQWxsb0Npbuk'' pour l'application Android) * ''q'' : chaîne à chercher (chaîne de caractères) * ''format'' (optionnel) : renvoie le résultat au format JSON ou XML (''json'' ou ''xml'') * ''filter'' (optionnel) : filtrer selon un type de résultat (énumeration de termes séparés par des virgules) * ''movie'' : afficher les films correspondant à la recherche * ''theater'' : afficher les cinémas * ''person'' : afficher les acteurs, réalisateurs, etc. (personnes) * ''news'' : afficher les news * ''tvseries'' : afficher les séries TV * ''count'' (optionnel) : nombre de résultats à renvoyer (entier) * Exemple : ''http://api.allocine.fr/rest/v3/search?partner=QUNXZWItQWxsb0Npbuk&filter=movie,theater,person,news,tvseries&count=5&page=1&q=avatar&format=json'' * ''page'' (optionnel) : numéro de la page de résultats à afficher (10 résultats par page par défaut) ==== Informations sur un film : movie ==== * URL : ''http://api.allocine.fr/rest/v3/movie'' * Paramètres * ''partner'' : code partenaire (''QUNXZWItQWxsb0Npbuk'' pour l'application Android) * ''code'' : identifiant du film (entier) * ''profile'' (optionnel) : degré d'informations renvoyées (valeurs possibles : ''small'', ''medium'', ''large'') * ''mediafmt'' (optionnel) : format vidéo * ''flv'' : FLV / H.264 * ''mp4-lc'' : MP4 / H.264 Baseline Profile, Low Complexity, with splashscreen * ''mp4-hip'' : H264 High Profile, with splashscreen * ''mp4-archive'' : MP4 / H.264 High Profile, for archive * ''mpeg2-theater'' : MPEG-2 720p * ''mpeg2'' : MPEG-2 Main Profile * et sûrement d'autres mais je n'ai pas le code correspondant ... * ''format'' (optionnel) : renvoie le résultat au format JSON ou XML (''json'' ou ''xml'') * ''filter'' (optionnel) : filtrer selon un type de résultat (énumeration de termes séparés par des virgules) * ''movie'' : afficher les films correspondant à la recherche * ''theater'' : afficher les cinémas * ''person'' : afficher les acteurs, réalisateurs, etc. (personnes) * ''news'' : afficher les news * ''tvseries'' : afficher les séries TV * ''striptags'' (optionnel) : supprime les tags HTML des paramètres valeurs passées en paramètre * Exemple : ''http://api.allocine.fr/rest/v3/movie?partner=QUNXZWItQWxsb0Npbuk&code=61282&profile=large&mediafmt=mp4-lc&format=json&filter=movie&striptags=synopsis,synopsisshort'' ==== Critiques sur un film (presse et public) : reviewlist ==== * URL : ''http://api.allocine.fr/rest/v3/reviewlist'' * Paramètres * ''partner'' : code partenaire (''QUNXZWItQWxsb0Npbuk'' pour l'application Android) * ''type'' : type (valeurs possibles : ''movie'', ???) * ''code'' : identifiant du film (entier) * ''filter'' : type de critique, presse (''desk-press'') ou public (''public'') * ''count'' (optionnel) : nombre de critiques à renvoyer (entier) * ''page'' (optionnel) : numéro de la page de résultats à afficher (10 résultats par page par défaut) * ''format'' (optionnel) : renvoie le résultat au format JSON ou XML (''json'' ou ''xml'') * Exemples : * ''http://api.allocine.fr/rest/v3/reviewlist?partner=QUNXZWItQWxsb0Npbuk&type=movie&code=61282&filter=public&count=30&format=json'' * ''http://api.allocine.fr/rest/v3/reviewlist?partner=QUNXZWItQWxsb0Npbuk&type=movie&filter=desk-press&code=61282&count=30&format=json'' A noter qu'une autre façon de construire la requête existe. Il faut pour cela utiliser le paramètre subject : ''http://api.allocine.fr/rest/v3/reviewlist?partner=QUNXZWItQWxsb0Npbuk&filter=public&subject=movie:61282&format=json''\\ Le reste des paramètres reste inchangé. ==== Horaires des cinémas : showtimelist ==== * URL : ''http://api.allocine.fr/rest/v3/showtimelist'' * Paramètres * ''partner'' : code partenaire (''QUNXZWItQWxsb0Npbuk'' pour l'application Android) * ''zip'' : code postal de la ville * ''lat'' : coordonnée latitude du cinéma * ''long'' : coordonnée longitude du cinéma * ''radius'' : rayon autour du point désigné (entre 1 et 500 km) * ''theaters'' : liste de codes de cinémas (séparé par une virgule, exemple: ''P0728,P0093'') * ''location'' : chaîne représentant le cinéma * ''movie'' (optionnel) : identifiant du film (si non précisé, affiche tous les films) * ''format'' (optionnel) : renvoie le résultat au format JSON ou XML (''json'' ou ''xml'') * ''date'' (optionnel) : date au format YYYY-MM-DD (si non précisé, date du jour) * Exemples : * ''http://api.allocine.fr/rest/v3/showtimelist?partner=QUNXZWItQWxsb0Npbuk&format=json&radius=50&lat=49.0176394&long=-0.3498428'' * ''http://api.allocine.fr/rest/v3/showtimelist?partner=QUNXZWItQWxsb0Npbuk&q=61282&format=xml&theaters=P0728'' * ''http://api.allocine.fr/rest/v3/showtimelist?partner=QUNXZWItQWxsb0Npbuk&q=61282&format=json&location=ugc%20mondeville'' * ''http://api.allocine.fr/rest/v3/showtimelist?partner=QUNXZWItQWxsb0Npbuk&q=61282&format=json&zip=14000'' ==== Informations sur une vidéo : media ==== * URL : ''http://api.allocine.fr/rest/v3/media'' * Paramètres * ''partner'' : code partenaire (''QUNXZWItQWxsb0Npbuk'' pour l'application Android) * ''code'' : identifiant de la vidéo (entier) * ''profile'' (optionnel) : degré d'informations renvoyées (valeurs possibles : ''small'', ''medium'', ''large'') * ''mediafmt'' (optionnel) : format vidéo * ''flv'' : FLV / H.264 * ''mp4-lc'' : MP4 / H.264 Baseline Profile, Low Complexity, with splashscreen * ''mp4-hip'' : H264 High Profile, with splashscreen * ''mp4-archive'' : MP4 / H.264 High Profile, for archive * ''mpeg2-theater'' : MPEG-2 720p * ''mpeg2'' : MPEG-2 Main Profile * et sûrement d'autres mais je n'ai pas le code correspondant ... * ''format'' (optionnel) : renvoie le résultat au format JSON ou XML (''json'' ou ''xml'') * Exemples : * ''http://api.allocine.fr/rest/v3/media?partner=QUNXZWItQWxsb0Npbuk&code=19135625&profile=large&mediafmt=mp4-lc&format=json'' ==== Informations sur une personne : person ==== * URL : ''http://api.allocine.fr/rest/v3/person'' * Paramètres * ''partner'' : code partenaire (''QUNXZWItQWxsb0Npbuk'' pour l'application Android) * ''code'' : identifiant de la personne (entier) * ''profile'' (optionnel) : degré d'informations renvoyées (valeurs possibles : ''small'', ''medium'', ''large'') * ''mediafmt'' (optionnel) : format vidéo * ''flv'' : FLV / H.264 * ''mp4-lc'' : MP4 / H.264 Baseline Profile, Low Complexity, with splashscreen * ''mp4-hip'' : H264 High Profile, with splashscreen * ''mp4-archive'' : MP4 / H.264 High Profile, for archive * ''mpeg2-theater'' : MPEG-2 720p * ''mpeg2'' : MPEG-2 Main Profile * et sûrement d'autres mais je n'ai pas le code correspondant ... * ''filter'' (optionnel) : filtrer selon un type de résultat (énumeration de termes séparés par des virgules) * ''movie'' : afficher les films correspondant à la recherche * ''theater'' : afficher les cinémas * ''person'' : afficher les acteurs, réalisateurs, etc. (personnes) * ''news'' : afficher les news * ''tvseries'' : afficher les séries TV * ''format'' (optionnel) : renvoie le résultat au format JSON ou XML (''json'' ou ''xml'') * Exemples : * ''http://api.allocine.fr/rest/v3/person?partner=QUNXZWItQWxsb0Npbuk&profile=large&code=41339&mediafmt=mp4-lc&filter=movie&format=json'' ==== Filmographie d'une personne : filmography ==== * URL : ''http://api.allocine.fr/rest/v3/filmography'' * Paramètres * ''partner'' : code partenaire (''QUNXZWItQWxsb0Npbuk'' pour l'application Android) * ''code'' : identifiant de la personne (entier) * ''profile'' (optionnel) : degré d'informations renvoyées (valeurs possibles : ''small'', ''medium'', ''large'') * ''filter'' (optionnel) : filtrer selon un type de résultat (énumeration de termes séparés par des virgules) * ''movie'' : afficher les films correspondant à la recherche * ''theater'' : afficher les cinémas * ''person'' : afficher les acteurs, réalisateurs, etc. (personnes) * ''news'' : afficher les news * ''tvseries'' : afficher les séries TV * ''format'' (optionnel) : renvoie le résultat au format JSON ou XML (''json'' ou ''xml'') * Exemples : * ''http://api.allocine.fr/rest/v3/filmography?partner=QUNXZWItQWxsb0Npbuk&profile=medium&code=41339&filter=movie&format=json'' ==== Liste des films en salle : movielist ==== * URL : ''http://api.allocine.fr/rest/v3/movielist'' * Paramètres * ''partner'' : code partenaire (''QUNXZWItQWxsb0Npbuk'' pour l'application Android) * ''code'' : identifiant de la personne (entier) * ''count'' (optionnel) : nombre de films à renvoyer (entier) * ''page'' (optionnel) : numéro de la page de résultats à afficher (10 résultats par page par défaut) * ''profile'' (optionnel) : degré d'informations renvoyées (valeurs possibles : ''small'', ''medium'', ''large'') * ''filter'' (optionnel) : filtrer selon un type de résultat (énumeration de termes séparés par des virgules) * ''nowshowing'' : afficher les films actuellement à l'affiche * ''comingsoon'' : afficher les films à paraitre * ''order'' (optionnel) : ordre de tri des résultats * ''datedesc'' : classement anti-chronologique * ''dateasc'' : classement chronologique * ''theatercount'' : classement par nombre de salles * ''toprank'' : classement par popularité * ''format'' (optionnel) : renvoie le résultat au format JSON ou XML (''json'' ou ''xml'') * Exemples : * Films en salle triées par nombre de salles : ''http://api.allocine.fr/rest/v3/movielist?partner=QUNXZWItQWxsb0Npbuk&count=25&filter=nowshowing&page=1&order=theatercount&format=json'' * Films en salle triées par date de sortie : ''http://api.allocine.fr/rest/v3/movielist?partner=QUNXZWItQWxsb0Npbuk&count=25&filter=nowshowing&page=1&order=datedesc&format=json'' * Films à paraitre les plus attendus : ''http://api.allocine.fr/rest/v3/movielist?partner=QUNXZWItQWxsb0Npbuk&count=25&filter=comingsoon&page=1&order=toprank&format=json'' * Films à paraitre triés par date : ''http://api.allocine.fr/rest/v3/movielist?partner=QUNXZWItQWxsb0Npbuk&count=25&filter=comingsoon&page=1&order=dateasc&format=json'' ==== Liste des cinémas : theaterlist ==== * URL : ''http://api.allocine.fr/rest/v3/theaterlist'' * Paramètres * ''partner'' : code partenaire (''QUNXZWItQWxsb0Npbuk'' pour l'application Android) * ''zip'' : code postal de la ville * ''lat'' : coordonnée latitude du cinéma * ''long'' : coordonnée longitude du cinéma * ''radius'' : rayon autour du point désigné (entre 1 et 500 km) * ''theater'' : code du cinéma (exemple: ''P0728'') * ''location'' : chaîne représentant le cinéma * ''format'' (optionnel) : renvoie le résultat au format JSON ou XML (''json'' ou ''xml'') * Exemples : * ''http://api.allocine.fr/rest/v3/theaterlist?partner=QUNXZWItQWxsb0Npbuk&count=25&page=1&lat=49.01716825&long=-0.3499346&format=json'' * ''http://api.allocine.fr/rest/v3/theaterlist?partner=QUNXZWItQWxsb0Npbuk&count=25&page=1&zip=14000&format=json'' ==== Informations sur une série TV : tvseries ==== * URL : ''http://api.allocine.fr/rest/v3/tvseries'' * Paramètres * ''partner'' : code partenaire (''QUNXZWItQWxsb0Npbuk'' pour l'application Android) * ''code'' : identifiant de la série (entier) * ''profile'' (optionnel) : degré d'informations renvoyées (valeurs possibles : ''small'', ''medium'', ''large'') * ''mediafmt'' (optionnel) : format vidéo * ''flv'' : FLV / H.264 * ''mp4-lc'' : MP4 / H.264 Baseline Profile, Low Complexity, with splashscreen * ''mp4-hip'' : H264 High Profile, with splashscreen * ''mp4-archive'' : MP4 / H.264 High Profile, for archive * ''mpeg2-theater'' : MPEG-2 720p * ''mpeg2'' : MPEG-2 Main Profile * et sûrement d'autres mais je n'ai pas le code correspondant ... * ''format'' (optionnel) : renvoie le résultat au format JSON ou XML (''json'' ou ''xml'') * ''striptags'' (optionnel) : supprime les tags HTML des paramètres valeurs passées en paramètre * Exemple : ''http://api.allocine.fr/rest/v3/tvseries?partner=QUNXZWItQWxsb0Npbuk&code=223&profile=large&mediafmt=mp4-lc&format=xml&striptags=synopsis,synopsisshort'' ==== Informations sur la saison d'une série TV : season ==== * URL : ''http://api.allocine.fr/rest/v3/season'' * Paramètres * ''partner'' : code partenaire (''QUNXZWItQWxsb0Npbuk'' pour l'application Android) * ''code'' : identifiant de la saison (entier) * ''profile'' (optionnel) : degré d'informations renvoyées (valeurs possibles : ''small'', ''medium'', ''large'') * ''mediafmt'' (optionnel) : format vidéo * ''flv'' : FLV / H.264 * ''mp4-lc'' : MP4 / H.264 Baseline Profile, Low Complexity, with splashscreen * ''mp4-hip'' : H264 High Profile, with splashscreen * ''mp4-archive'' : MP4 / H.264 High Profile, for archive * ''mpeg2-theater'' : MPEG-2 720p * ''mpeg2'' : MPEG-2 Main Profile * et sûrement d'autres mais je n'ai pas le code correspondant ... * ''format'' (optionnel) : renvoie le résultat au format JSON ou XML (''json'' ou ''xml'') * ''striptags'' (optionnel) : supprime les tags HTML des paramètres valeurs passées en paramètre * Exemple : ''http://api.allocine.fr/rest/v3/season?partner=QUNXZWItQWxsb0Npbuk&code=12277&profile=large&mediafmt=mp4-lc&format=xml&striptags=synopsis,synopsisshort'' ==== Informations sur l'épisode d'une série TV : episode ==== * URL : ''http://api.allocine.fr/rest/v3/episode'' * Paramètres * ''partner'' : code partenaire (''QUNXZWItQWxsb0Npbuk'' pour l'application Android) * ''code'' : identifiant de la saison (entier) * ''profile'' (optionnel) : degré d'informations renvoyées (valeurs possibles : ''small'', ''medium'', ''large'') * ''mediafmt'' (optionnel) : format vidéo * ''flv'' : FLV / H.264 * ''mp4-lc'' : MP4 / H.264 Baseline Profile, Low Complexity, with splashscreen * ''mp4-hip'' : H264 High Profile, with splashscreen * ''mp4-archive'' : MP4 / H.264 High Profile, for archive * ''mpeg2-theater'' : MPEG-2 720p * ''mpeg2'' : MPEG-2 Main Profile * et sûrement d'autres mais je n'ai pas le code correspondant ... * ''format'' (optionnel) : renvoie le résultat au format JSON ou XML (''json'' ou ''xml'') * ''striptags'' (optionnel) : supprime les tags HTML des paramètres valeurs passées en paramètre * Exemple : ''http://api.allocine.fr/rest/v3/episode?partner=QUNXZWItQWxsb0Npbuk&code=233016&profile=large&mediafmt=mp4-lc&format=xml&striptags=synopsis,synopsisshort'' ===== Ils se servent de l'API ===== Si jamais vous tombez sur cette page et que vous vous servez de cette API, je me ferais une joie de lister votre application ici.\\ \\ * EzTvix : http://blog.eztvix.info * Str9am : http://www.abysscorp.org/project/str9am * Ma filmothèque : http://ma-filmotheque.fr * WebMovieManager : http://sourceforge.net/projects/webmoviemanager/ * AlloWMC : https://sites.google.com/site/allowmc/home * Lib Ruby : https://rubygems.org/gems/allocine_parser & https://github.com/mlamarque/allocine * Lib DotNet : http://allocineapi.codeplex.com/ * Application Android CinéMinute : https://play.google.com/store/apps/details?id=info.toyonos.cineminute * Cinegeek : http://cinegeek.alwaysdata.net/ * API CoffeeScript : https://github.com/cedias/AlloCoffee * Application Android CinéTime : https://play.google.com/store/apps/details?id=fr.neamar.cinetime * MovieFlow Android : http://www.movieflow.net/ * Module Node.js : https://github.com/leeroybrun/node-allocine-api ===== Remarques ===== Il y a peut-être (sûrement) des oublis, donc si vous trouvez quelque chose qui ne va pas ou alors un nouveau service, contactez moi via le [[:contact|formulaire de contact]] ou bien directement sur mon mail ===== Remerciements ===== Merci à tout ceux qui m'ont contacté pour me signaler des nouveaux services, comme Olivier B. pour m'avoir mis sur la piste pour les séries ;-) {{keywords>allocine api film films movie movies search recherche xml json movielist api.allocine.fr webservice webservices web service série séries tv show tvshow}}