Skip to main content
The creator() method retrieves comprehensive information about a creator (director, actor, writer, etc.) from ČSFD, including their biography and complete filmography.

Signature

csfd.creator(creator: number, options?: CSFDOptions): Promise<CSFDCreator>

Parameters

creator
number
required
The ČSFD creator ID. You can find this in the creator’s URL: https://www.csfd.cz/tvurce/2120-quentin-tarantino → ID is 2120
options
CSFDOptions
Override default options for this request

Returns

CSFDCreator
object
Complete creator information including biography and filmography

Examples

Basic Usage

import { csfd } from 'node-csfd-api';

const creator = await csfd.creator(2120); // Quentin Tarantino

console.log(creator.name); // "Quentin Tarantino"
console.log(creator.birthday); // "27.03.1963"
console.log(creator.birthplace); // "Knoxville, Tennessee, USA"
console.log(creator.age); // 58

Accessing Filmography

const creator = await csfd.creator(2120);

// Display all films
creator.films.forEach(film => {
  console.log(`${film.title} (${film.year}) - ${film.colorRating}`);
});

// Output:
// Tenkrát v Hollywoodu (2019) - good
// Osm hrozných (2015) - good
// Nespoutaný Django (2012) - good
// ...

Filter by Rating

const creator = await csfd.creator(2120);

// Get only highly-rated films
const topFilms = creator.films.filter(film => film.colorRating === 'good');

console.log(`${creator.name} has ${topFilms.length} highly-rated films`);

Find Specific Film

const creator = await csfd.creator(2120);

// Find a specific film by title
const pulpFiction = creator.films.find(film => 
  film.title.includes('Pulp Fiction')
);

if (pulpFiction) {
  console.log(`Film ID: ${pulpFiction.id}`);
  
  // Get full movie details
  const movieDetails = await csfd.movie(pulpFiction.id);
}

Display Biography

const creator = await csfd.creator(2120);

console.log(`Name: ${creator.name}`);
console.log(`Born: ${creator.birthday} in ${creator.birthplace}`);
console.log(`Age: ${creator.age}`);
console.log(`\nBiography:\n${creator.bio}`);
console.log(`\nPhoto: ${creator.photo}`);
import { csfd } from 'node-csfd-api';

// First search for the creator
const searchResults = await csfd.search('Christopher Nolan');

if (searchResults.creators.length > 0) {
  const creatorId = searchResults.creators[0].id;
  
  // Then get full details
  const creator = await csfd.creator(creatorId);
  
  console.log(`${creator.name} has directed ${creator.films.length} films`);
}

With Language Option

const creator = await csfd.creator(2120, {
  language: 'en'
});

// Biography and some fields may be in English when available
console.log(creator.bio);

Build docs developers (and LLMs) love