Welcome
We are always aiming to deliver the newest video material in the highest quality to our subscribers on YouTube. We do not just straight up copy the uploads of other channels, instead we try to deliver a superior experience by only allowing the highest quality source material on our channels, pairing it with years of graphics and editing expertise and combining it with cutting edge technology.
We are working with over 100 publishers and many press agencies around the world and deliver over 900 exklusive videos to our subscribers. If you need a source for EPK material for your own website or app, this API is the perfect and free solution for you. Follow the instructions and examples and get the video ID of our high quality YouTube uploads and simply embed them.
Featured Users
/movies
Request
GET https://api.kinocheck.de/movies
Parameters
The following table lists the parameters that this query supports. All of the parameters listed are query parameters.
Required (specify exactly one of the following parameters) | ||
---|---|---|
id | string | The ID used by KinoCheck |
tmdb_id | integer | The ID used by TMDB |
imdb_id | string | The ID used by IMDB |
Optional | ||
---|---|---|
language | string | The parameter specifies a two-letter ISO 639 language code which will determine the language-sensitive output of the API, e.g. the title of the movie and the spoken-language of the videos. Acceptable values are:
|
categories | string | The parameter specifies a comma-separated list of one or more video category properties that the videos property of the API response will include. This does not effect the trailer property. Exclude categories by prepending a hyphen. Acceptable values are:
|
Examples
GET https://api.kinocheck.de/movies?tmdb_id=299534
GET https://api.kinocheck.de/movies?tmdb_id=299534&language=de
GET https://api.kinocheck.de/movies?tmdb_id=299534&language=de&categories=Trailer
GET https://api.kinocheck.de/movies?tmdb_id=299534&language=de&categories=Trailer,-Clip
Response
If successful, this method returns a response body with the following structure:
{ "id": "ly4", "tmdb_id": 299534, "imdb_id": "tt4154796", "language": "de", "title": "Avengers 4: Endgame", "url": "https://kinocheck.de/film/ly4/avengers-4-2019", "trailer": video resource, "videos": [ video resource ] }
Properties
The following table defines the properties that appear in this resource:
id | string | The ID used by KinoCheck |
tmdb_id | integer | The ID used by TMDB. Returns null if no TMDB ID is found |
imdb_id | string | The ID used by IMDB. Returns null if no IMDB ID is found |
language | string | The language used in the API request, represented by a two-letter ISO 639 language code (e.g. "en", "de") |
title | string | The title of the movie |
url | string | The URL to the movie detail page |
trailer | video resource | An automatically selected single video resource with the sole category "Trailer". Returns null if no acceptable video is found |
videos | array | An array of video resources associated with the movie resource. The array will be empty if no videos are found |
/shows
See the corresponding documentation for /movies. You cannot filter by seasons or get any informations about single seasons.
Examples
GET https://api.kinocheck.de/shows?tmdb_id=38472
GET https://api.kinocheck.de/shows?tmdb_id=38472&language=de
GET https://api.kinocheck.de/shows?tmdb_id=38472&language=de&categories=Trailer
Video resource
The following JSON structure shows the format of a video resource:
{ "id": "4ghv", "youtube_video_id": "EJJedP2_7_k", "youtube_channel_id": "UCOL10n-as9dXO2qtjjFUQbQ", "youtube_thumbnail": "https://img.youtube.com/vi/EJJedP2_7_k/maxresdefault.jpg", "title": "AVENGERS 4: Endgame Trailer German Deutsch (2019)", "thumbnail": "https://images.kinocheck.de/images/hsd2ascncd.jpg", "language": "de", "categories": [ "Trailer" ], "published": "2018-12-07T13:16:51+01:00", "views": "1391790" }
Properties
The following table defines the properties that appear in this resource:
id | string | The ID used by KinoCheck |
youtube_video_id | string | The ID used by YouTube |
youtube_channel_id | string | The channel ID used by YouTube |
youtube_thumbnail | string | A link to the thumbnail used by YouTube |
title | string | The title of the video |
thumbnail | string | The thumbnail used by KinoCheck.de. Probably the same as YouTube. The URL to this thumbnail will change from time to time. Just use it to mirror on your own server. |
language | string | Two-letter ISO 639 code of the spoken language in the video |
categories | array | An array of categories to which the video belongs. A video can be in multiple categories at the same time, e.g. "Trailer" and "Clip" |
views | integer | The current views of the video on YouTube |