movie() method fetches detailed information about a movie, TV series, episode, or season from ČSFD by its ID.
Signature
csfd.movie(movie: number, options?: CSFDOptions): Promise<CSFDMovie>
Parameters
The ČSFD movie ID. You can find this in the movie’s URL:
https://www.csfd.cz/film/535121 → ID is 535121Returns
Complete movie information including metadata, cast, crew, and related content
Show properties
Show properties
ČSFD movie ID
Movie title
Release year
Full URL to the movie page on ČSFD
Content type: ‘film’, ‘series’, ‘tv-film’, ‘episode’, ‘season’, etc.
Overall rating indicator:
- ‘good’: 70% – 100% (red color on ČSFD)
- ‘average’: 30% – 69% (blue color)
- ‘bad’: 0% – 29% (black color)
- ‘unknown’: No rating (gray color)
Percentage rating (0-100)
Number of user ratings
URL to the movie poster image
URL to the main movie photo/still
Movie duration in minutes or formatted string
Array of plot descriptions in different languages
Array of genre names (e.g., [‘Krimi’, ‘Drama’, ‘Thriller’])
Countries of origin (e.g., [‘USA’, ‘Kanada’])
Cast and crew information
Show properties
Show properties
Array of directors
Array of screenplay writers
Array of actors
Array of composers
Array of producers
Array of cinematographers
Array of editors
Original work authors
Costume designers
Production designers
Array of interesting facts and trivia
User-generated tags
Related movies (sequels, prequels, etc.)
Similar movies
Season list (for TV series)
Episode list (for seasons)
Episode code (e.g., ‘S01E05’)
Season name
Examples
Basic Usage
import { csfd } from 'node-csfd-api';
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"]
With Language Option
const movie = await csfd.movie(535121, {
language: 'en'
});
// Descriptions and some fields may be in English when available
console.log(movie.descriptions);
Accessing Cast and Crew
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); // "https://www.csfd.cz/tvurce/87470-s-craig-zahler/"
// List all actors
movie.creators.actors.forEach(actor => {
console.log(actor.name);
});
VOD Availability
const movie = await csfd.movie(535121);
// Check where the movie is available
movie.vod.forEach(platform => {
console.log(`${platform.title}: ${platform.url}`);
});
// Output:
// Voyo: https://voyo.nova.cz/filmy/4604-na-spatne-strane
// DVD: https://filmy.heureka.cz/...
Related
- CSFDMovie Type
- CSFDOptions Type
- search() - Search for movies
- creator() - Get creator details