movie() method retrieves detailed information about any movie, TV series, season, or episode from ČSFD. It returns comprehensive data including ratings, cast, crew, trivia, VOD availability, and more.
Method Signature
csfd.movie(id: number, options?: CSFDOptions): Promise<CSFDMovie>
Parameters
The ČSFD movie ID. You can find this in the movie’s URL (e.g.,
535121 from https://www.csfd.cz/film/535121)Return Type
Complete movie information object
Show properties
Show properties
ČSFD movie ID
Movie title (localized based on language option)
Release year
Content type:
'film', 'series', 'season', 'episode', 'tv-film', 'tv-show', etc.Full URL to the movie on ČSFD
Average user rating (0-100 scale)
Number of user ratings
Overall rating quality indicator (good: 70-100%, average: 30-69%, bad: 0-29%)
Runtime in minutes or formatted duration string
URL to the official poster image
URL to a random photo from the movie
Array of genres (e.g.,
['Krimi', 'Drama', 'Thriller'])Countries of origin (e.g.,
['USA', 'Kanada'])Plot descriptions (multiple language variants may be available)
Interesting facts and trivia about the movie
Cast and crew information
Show properties
Show properties
User-generated tags
Related movies (prequels, sequels, etc.)
Similar movies
Array of seasons (only for TV series)
Array of episodes (only for seasons)
Parent series/season information (for episodes and seasons)
Episode code (e.g., “S01E05”) for episodes
Season name (for seasons)
Usage Examples
- Basic Usage
- With Language Option
- Promise Syntax
- Accessing Cast & Crew
import { csfd } from 'node-csfd-api';
// Fetch movie details
const movie = await csfd.movie(535121);
console.log(movie.title); // "Na špatné straně"
console.log(movie.year); // 2018
console.log(movie.rating); // 73
console.log(movie.genres); // ['Krimi', 'Drama', 'Thriller']
import { csfd } from 'node-csfd-api';
// Fetch movie in English
const movie = await csfd.movie(535121, { language: 'en' });
// Fetch movie in Slovak
const movieSk = await csfd.movie(535121, { language: 'sk' });
import { csfd } from 'node-csfd-api';
csfd.movie(535121)
.then((movie) => {
console.log(movie.title);
console.log(movie.creators.directors);
});
import { csfd } from 'node-csfd-api';
const movie = await csfd.movie(535121);
// Get director information
const director = movie.creators.directors[0];
console.log(director.name); // "S. Craig Zahler"
console.log(director.id); // 87470
console.log(director.url); // ČSFD URL
// Get main actors
movie.creators.actors.forEach(actor => {
console.log(actor.name);
});
Example Response
Example Response
{
"id": 535121,
"title": "Na špatné straně",
"year": "2018",
"descriptions": [
"Otupělý policejní veterán Ridgeman (Mel Gibson)...",
"Brett je policajt tesne ..."
],
"genres": ["Krimi", "Drama", "Thriller"],
"type": "film",
"url": "https://www.csfd.cz/film/535121",
"origins": ["USA", "Kanada"],
"colorRating": "good",
"rating": 73,
"ratingCount": 6654,
"photo": "//image.pmgstatic.com/cache/resized/w1326/files/images/film/photos/162/980/162980090_bbffbb.jpg",
"trivia": [
"Když Henry (Tory Kittles) se svým mladším bratrem...",
"Ve filmu se střídají..."
],
"titlesOther": [
{ "country": "USA", "title": "Dragged Across Concrete" },
{ "country": "Kanada", "title": "Dragged Across Concrete" },
{ "country": "Slovensko", "title": "Na zlej strane" },
{ "country": "Austrálie", "title": "Dragged Across Concrete" },
{ "country": "Velká Británie", "title": "Dragged Across Concrete" }
],
"poster": "https://image.pmgstatic.com/cache/resized/w1080/files/images/film/posters/163/579/163579352_bf8737.jpg",
"creators": {
"directors": [
{
"id": 87470,
"name": "S. Craig Zahler",
"url": "https://www.csfd.cz/tvurce/87470-s-craig-zahler/"
}
],
"actors": [
{
"id": 1,
"name": "Mel Gibson",
"url": "https://www.csfd.cz/tvurce/1-mel-gibson/"
}
],
"basedOn": [],
"writers": [
{
"id": 87470,
"name": "S. Craig Zahler",
"url": "https://www.csfd.cz/tvurce/87470-s-craig-zahler/"
}
],
"music": [
{
"id": 203209,
"name": "Jeff Herriott",
"url": "https://www.csfd.cz/tvurce/203209-jeff-herriott/"
}
],
"producers": [
{
"id": 320006,
"name": "Sefton Fincham",
"url": "https://www.csfd.cz/tvurce/320006-sefton-fincham/"
}
]
},
"vod": [
{
"title": "Voyo",
"url": "https://voyo.nova.cz/filmy/4604-na-spatne-strane"
},
{
"title": "DVD",
"url": "https://filmy.heureka.cz/na-spatne-strane-dvd/#utm_source=csfd.cz&utm_medium=cooperation&utm_campaign=csfd_movies_feed"
}
],
"tags": ["město", "sledování"],
"premieres": [
{
"country": "Česko",
"format": "Na Blu-ray",
"date": "07.08.2019",
"company": "Magic Box"
},
{
"country": "USA",
"format": "V kinech",
"date": "22.03.2019",
"company": "Lionsgate US"
}
]
}
The
movie() method works for all content types on ČSFD including regular films, TV films, TV series, individual seasons, and episodes.Be mindful of rate limiting when making multiple requests. Consider implementing delays between consecutive calls to avoid being blocked.