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
Search query text. Can be movie titles, creator names, or usernames.
Override default options for this request Preferred language for content (default: ‘cs’)
Custom fetch request options (headers, timeout, etc.)
Returns
Search results organized by content type Array of matching movies Full URL to the movie page
Content type (e.g., ‘film’, ‘tv-film’)
colorRating
'bad' | 'average' | 'good' | 'unknown'
Overall rating indicator
Basic creator information Array of matching TV series (same structure as movies)
Array of matching creators Full URL to the creator page
Array of matching users URL to user’s avatar image
Full URL to the user profile
Examples
Basic Search
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 ( ` \n Search 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 ( ' \n TV Series:' );
results . tvSeries . forEach ( series => {
console . log ( ` - ${ series . title } ( ${ series . year } )` );
});
}
// Creators
if ( results . creators . length > 0 ) {
console . log ( ' \n Creators:' );
results . creators . forEach ( creator => {
console . log ( ` - ${ creator . name } ` );
});
}
// Users
if ( results . users . length > 0 ) {
console . log ( ' \n Users:' );
results . users . forEach ( user => {
console . log ( ` - ${ user . user } ( ${ user . userRealName } )` );
});
}
}
await searchAndDisplayResults ( 'Tarantino' );