API AlloCiné v3

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

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 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 :

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 formulaire de contact ou bien directement sur mon mail jerome.groven@gmail.com

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 ;-)