The search() method allows you to search for content across the entire ČSFD database. It returns movies, TV series, creators, and users that match your search query.
Method Signature csfd . search ( query : string , options ?: CSFDOptions ): Promise < CSFDSearch >
Parameters Search query string. Can be a movie title, person name, or username.
Optional configuration object Language variant to use. Defaults to 'cs' (Czech)
Custom request options (headers, cookies, etc.)
Return Type Search results containing movies, TV series, creators, and users Array of matching movies Full URL to the movie on ČSFD
Content type (e.g., 'film', 'tv-film', 'tv-show')
colorRating
'bad' | 'average' | 'good' | 'unknown'
Overall rating quality indicator
Cast and crew information Directors with id, name, and url
Main actors with id, name, and url
Array of matching TV series (same structure as movies)
Array of matching creators (directors, actors, etc.) Array of matching ČSFD users Usage Examples Basic Search
Search Movies
Search Users
Filter by Type
import { csfd } from 'node-csfd-api' ; // Search for content const results = await csfd . search ( 'Tarantino' ); console . log ( results . movies ); // Array of movies console . log ( results . tvSeries ); // Array of TV series console . log ( results . users ); // Array of users
import { csfd } from 'node-csfd-api' ; const results = await csfd . search ( 'bart' ); // Access movie results results . movies . forEach ( movie => { console . log ( ` ${ movie . title } ( ${ movie . year } )` ); console . log ( `Rating: ${ movie . colorRating } ` ); console . log ( `URL: ${ movie . url } ` ); });
import { csfd } from 'node-csfd-api' ; const results = await csfd . search ( 'bart' ); // Access user results results . users . forEach ( user => { console . log ( ` ${ user . user } - ${ user . userRealName } ` ); console . log ( `Avatar: ${ user . avatar } ` ); });
import { csfd } from 'node-csfd-api' ; const results = await csfd . search ( 'Kingdom' ); // Filter TV series only const series = results . tvSeries . filter ( item => item . type === 'series' ); // Filter films only const films = results . movies . filter ( item => item . type === 'film' );
{ "movies" : [ { "id" : 19653 , "title" : "Black Bart" , "year" : "1975" , "url" : "https://www.csfd.cz/film/19653-black-bart/" , "type" : "tv-film" , "colorRating" : "bad" , "poster" : "data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7" , "origins" : [ "USA" ], "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/" } ] } } ], "tvSeries" : [ { "id" : 71924 , "title" : "Království" , "year" : 1994 , "url" : "https://www.csfd.cz/film/71924-kralovstvi/" , "type" : "series" , "colorRating" : "good" , "poster" : "https://image.pmgstatic.com/cache/resized/w60h85/files/images/film/posters/166/708/166708064_2da697.jpg" , "origins" : [ "Dánsko" ], "creators" : [] } ], "users" : [ { "id" : 912 , "user" : "BART!" , "userRealName" : "Lukáš Barták" , "avatar" : "https://image.pmgstatic.com/cache/resized/w45h60/files/images/user/avatars/000/281/281554_1c0fef.jpg" , "url" : "https://www.csfd.cz/uzivatel/912-bart/" } ], "creators" : [] }
Search results are limited to what ČSFD returns on the first page. For more specific results, try using more detailed search queries.
You can use the returned IDs to fetch detailed information using the movie() or creator() methods.