Skip to main content
The search() method performs a comprehensive search across ČSFD’s database, returning matching movies, TV series, creators, and users.

Signature

csfd.search(text: string, options?: CSFDOptions): Promise<CSFDSearch>

Parameters

text
string
required
Search query text. Can be movie titles, creator names, or usernames.
options
CSFDOptions
Override default options for this request

Returns

Search results organized by content type

Examples

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

const results = await csfd.search('Tarantino');

console.log(results.movies); // Movies related to "Tarantino"
console.log(results.tvSeries); // TV series
console.log(results.creators); // Creators (Quentin Tarantino, etc.)
console.log(results.users); // Users with "Tarantino" in name

Search for Movies Only

const results = await csfd.search('Pulp Fiction');

// Display movie results
results.movies.forEach(movie => {
  console.log(`${movie.title} (${movie.year})`);
  console.log(`Rating: ${movie.colorRating}`);
  console.log(`URL: ${movie.url}`);
});

Search for Creators

const results = await csfd.search('Christopher Nolan');

if (results.creators.length > 0) {
  const creator = results.creators[0];
  console.log(creator.name); // "Christopher Nolan"
  console.log(creator.id); // Creator ID for use with creator() method
  
  // Get full creator details
  const details = await csfd.creator(creator.id);
}

Search with Language Option

const results = await csfd.search('bart', {
  language: 'en'
});

// Results may include English-language content when available

Complete Search Flow

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

async function searchAndDisplayResults(query: string) {
  const results = await csfd.search(query);
  
  console.log(`\nSearch results for "${query}":\n`);
  
  // Movies
  if (results.movies.length > 0) {
    console.log('Movies:');
    results.movies.forEach(movie => {
      console.log(`  - ${movie.title} (${movie.year}) [${movie.colorRating}]`);
    });
  }
  
  // TV Series
  if (results.tvSeries.length > 0) {
    console.log('\nTV Series:');
    results.tvSeries.forEach(series => {
      console.log(`  - ${series.title} (${series.year})`);
    });
  }
  
  // Creators
  if (results.creators.length > 0) {
    console.log('\nCreators:');
    results.creators.forEach(creator => {
      console.log(`  - ${creator.name}`);
    });
  }
  
  // Users
  if (results.users.length > 0) {
    console.log('\nUsers:');
    results.users.forEach(user => {
      console.log(`  - ${user.user} (${user.userRealName})`);
    });
  }
}

await searchAndDisplayResults('Tarantino');

Build docs developers (and LLMs) love