Movieplayer.it REST API documentation (v1)

This document describes the REST API and resources provided by Movieplayer.it. This API is for developers who want to retrieve information on movies from the website movieplayer.it.
In order to use this API you have to request an api key. Please write an email to supporto@movieplayer.it specifying your movieplayer.it email.
If you're not yet a movieplayer.it registered user, please register first and then request your api key.

The Movieplayer.it REST API provides read-only access to resources (data entities) via URI paths using the standard HTTP GET method. To use a REST API, your application will make an HTTP request and parse the response.
Currently, the only supported response format is JSON.

Terms of use

Movieplayer.it:

Structure of the REST URIs

Sample call to the API:

While accessing the API via browser, remember to pass the query parameter
format=json
in the URL.

RESOURCES

Update (5 June 2014):


*** Movies ***

/api/v1/movie/search/?q

Basic search in the movie database.

Request query parameters:

Example:

/api/v1/movie/{id}/?type

Shows data for a specific movie.

Uri parameters:

Request query parameters:

Examples:

Output

Each JSON object representing a movie has the following structure:

Example:

{
    "id": "9803", 
    "imdbid": "tt0499549",
    "name": "Avatar", 
    "original": "Avatar", 
    "year": 2009,
    "duration": "162", 
    "genres": [
        "Azione", 
        "Fantascienza"
    ],
    "plot": "Jake Sully, un ex Marine costretto a vivere sulla sedia a rotelle, \u00e8, tutto sommato, ancora un combattente. 
        E' stato reclutato per viaggiare anni luce sino all'avamposto umano su Pandora, dove alcune societ\u00e0 stanno estraendo un raro minerale 
        che \u00e8 la chiave per risolvere la crisi energetica sulla Terra.[...]", 
    "poster": {
        "thumb": "http://images.movieplayer.it/2011/05/30/locandina-ufficiale-italiana-di-avatar-204858_medium.jpg", 
        "url": "http://images.movieplayer.it/2011/05/30/locandina-ufficiale-italiana-di-avatar-204858.jpg"
    }, 
    "absolute_url": "http://movieplayer.it/film/avatar_9803/", 
    "moviescore": "4.13852", 
    "review_url": "http://movieplayer.it/film/articoli/il-nuovo-mondo-su-pandora_6494/", 
    "trailer": {
        "file_url": "http://video.movieplayer.it/trailer/2009/11/04/avatar-trailer-italiano-4736.flv", 
        "image_url": "http://images.movieplayer.it/2009/11/04/avatar-trailer-italiano-4736.jpg", 
        "url": "http://movieplayer.it/video/avatar-trailer-italiano_4736/"
    },
    "videoreview": {}, 
    "actors": [
        "Sam Worthington", 
        "Zoe Saldana", 
        "Sigourney Weaver"
    ], 
    "directors": [
        "James Cameron"
    ], 
    "screenwriters": [
        "James Cameron"
    ], 
    "homevideos": [
        {
            "name": "Avatar Extended Collector's Edition - blu-ray (2010)", 
            "packshot": "http://images.movieplayer.it/2010/10/05/la-copertina-di-avatar-extended-collector-s-edition-blu-ray-177620_medium.jpg"
        }, 
        {
            "name": "Avatar - blu-ray (2010)", 
            "packshot": "http://images.movieplayer.it/2010/03/25/la-copertina-di-avatar-blu-ray-150957_medium.jpg"
        }
    ], 
    "images": {
        "event": [
            {
                "thumb": "http://images.movieplayer.it/2009/07/29/comic-con-di-san-diego-1009-james-cameron-durante-il-panel-di-presentazione-del-suo-film-avatar-125674_medium.jpg", 
                "url": "http://images.movieplayer.it/2009/07/29/comic-con-di-san-diego-1009-james-cameron-durante-il-panel-di-presentazione-del-suo-film-avatar-125674.jpg"
            }
        ], 
        "poster": [
            {
                "thumb": "http://images.movieplayer.it/2008/08/02/poster-del-film-84783_medium.jpg", 
                "url": "http://images.movieplayer.it/2008/08/02/poster-del-film-84783.jpg"
            }
        ], 
        "promo": [
            {
                "thumb": "http://images.movieplayer.it/2010/07/10/sam-worthington-zoe-saldana-e-sigourney-weaver-in-uno-scatto-promo-alla-premiere-francese-di-avatar-168179_medium.jpg", 
                "url": "http://images.movieplayer.it/2010/07/10/sam-worthington-zoe-saldana-e-sigourney-weaver-in-uno-scatto-promo-alla-premiere-francese-di-avatar-168179.jpg"
            }
        ], 
        "still-frame": [
            {
                "thumb": "http://images.movieplayer.it/2009/11/29/una-scena-del-film-avatar-con-l-attore-stephen-lang-che-interpreta-il-col-quaritch-140139_medium.jpg", 
                "url": "http://images.movieplayer.it/2009/11/29/una-scena-del-film-avatar-con-l-attore-stephen-lang-che-interpreta-il-col-quaritch-140139.jpg"
            }
        ], 
        "wallpaper": [
            {
                "thumb": "http://images.movieplayer.it/2010/02/02/un-wallpaper-ufficiale-con-sam-worthington-e-il-suo-avatar-nell-omonimo-film-145750_medium.jpg", 
                "url": "http://images.movieplayer.it/2010/02/02/un-wallpaper-ufficiale-con-sam-worthington-e-il-suo-avatar-nell-omonimo-film-145750.jpg"
            }
        ]
    }
}

*** TV Series ***

/api/v1/tvseries/search/?q

Basic search in the tv series database.

Request query parameters:

Example:

/api/v1/tvseries/{id}/?type

Shows data for a specific tv series.

Uri parameters:

Request query parameters:

Examples:

Output

Each JSON object representing a tv series has the following structure (for an example see above in the movie section):