Loading...

icon-back icon-facebook icon-paperplane icon-github icon-arrow-right icon-arrow-left icon_arrow_up icon-exit icon-star icon-filter
MENU

Icelandic movie API

Introduction

The Icelandic movie API is a free REST service for obtaining information about movies showing in Icelandic cinemas. To use this service please fill out the short registration form here below.


The API is mainly built with data from open_in_newkvikmyndir.is. Special thanks to them for their contribution. In addition I have added data from open_in_newbioparadis.is and other services such as open_in_newOMDB API and open_in_newThe Movie Database API. The data from the API is updated daily.


Authentication

The API is for non commercial purposes only because of third party data. Please explain briefly in the register form for what purpose you are going to use the API.


The API uses token based authentication. Before you can access any data from the API you will have to make an authentication POST request.

Below is an example of how you can authenticate and receive your token. First make a POST request to open_in_newhttps://api.kvikmyndir.is/authenticate with your username and password as credentials. If the credentials match your user the server will send back JSON response which will include your token. Your token will expire after 24 hours.


Example


All requests to the API will have to include a token for authentication. A GET request to open_in_newhttps://api.kvikmyndir.is/movies can either have header field set as 'x-access-token' or have a token included as a query string parameter. If the token is correct the server will respond with data from the server.


Endpoints

Below is a list of all available endpoints in the API. All responses are in JSON format. For testing I recommend using applications such as open_in_newPostman, open_in_newAdvanced REST client or open_in_newJSONView.


If you have any problems or questions regarding the API than please feel free to contact me.



Now playing


Method Requests Params Description Example
GET /movies

/

title

imdbid

imdbrating

showtime

certificate

actor

director

mongoid

All movies now playing in cinemas

Filters movies by title name

Filters movies by imdbid

Filters movies with bigger rating than number

Filters movies by showtime bigger than time

Filters movies by certificate

Filters movies by actor

Filters movies by director

Filters movies by mongoid

N/A

/movies?title=The Revenant

/movies?imdbid=tt1663202

/movies?imdbrating=8.0

/movies?showtime=20:00

/movies?certificate=16

/movies?actor=Tom Hardy

/movies?director=Alejandro

/movies?mongoid=56e50...


Coming soon


Method Requests Params Description Example
GET /upcoming

/

title

imdbid

actor

director

mongoid

All upcoming movies

Filters movies by title name

Filters movies by imdbid

Filters movies by actor

Filters movies by director

Filters movies by mongoid

N/A

/upcoming?title=The Revenant

/upcoming?imdbid=tt1663202

/upcoming?actor=Tom Hardy

/upcoming?director=Alejandro

/upcoming?mongoid=56e50...


Posters and backdrops

For additional posters and backdrops make a request to TMDB and construct path from given JSON data from the response.

Instructions:

Baseurl: http://image.tmdb.org/t/p/

Image width: w500, w1000, w1920

Filepath: eTILB3qfPlj0Z01Meb1eBkXDnSa.jpg

Url: http://image.tmdb.org/t/p/w1920/eTILB3qfPlj0Z01Meb1eBkXDnSa.jpg


Method Requests Params Description Example
GET /images

/

imdbid

All movies with extra images

Filters movies by imdbid

N/A

/images?imdbid=tt1663202


Genres


Method Requests Description
GET /genres

List of all genres


Cinemas


Method Requests Description
GET /cinemas

List of all Icelandic cinemas