CSFD API 🎥 2025

JavaScript NPM library for scraping Czech Movie Database (csfd.cz)

• JavaScript / TypeScript
• Browser + Node.js (SSR)
• Tested (~100% Code coverage)
• ✅ Ready for new ČSFD 2025!
• You can use in:
  • Docker – How to do it?
  • Firebase function
  • AWS λ (lambda function)
  • CloudFlare Worker
  • Chrome extension
  • React native app
  • Browsers (Pay attention to CORS)

🗜️ Install

npm install node-csfd-api
# yarn add node-csfd-api

🛠️ Usage and examples

• Movies and TV Series
• User Ratings
• Search
• Creators

Movie

Get info about this movie (id: 535121)

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

csfd.movie(535121).then((movie) => console.log(movie));

Search

Search movies, users and TV series

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

csfd.search('bart').then((search) => console.log(search));

Creators

Get creator info + filmography

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

csfd.creator(2120).then((creator) => console.log(creator));

User Ratings

Last ratings (last page)

Get my last 50 ratings

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

csfd.userRatings('912-bart').then((ratings) => console.log(ratings));

All ratings (all pages)

Warning: Use it wisely. Can be detected and banned. Consider using it together with allPagesDelay attribute.

Get all of my ratings

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

csfd
  .userRatings('912-bart', {
    allPages: true, // Download all pages (one by one)
    allPageDelay: 2000 // Make delay 2000ms on each page request
  })
  .then((ratings) => console.log(ratings));

Options for user ratings

Note: You can not use both parameters includesOnly and excludes. Parameter includesOnly has a priority.

📦 Docker

You can use this library in Docker.

We have prepared a Docker image for you.

Prebuilt image

docker pull bartholomej/node-csfd-api

Build & run your own image

Build image

docker build -t node-csfd-api .

Run image on port 3000

docker run -p 3000:3000 node-csfd-api

Open http://localhost:3000

API endpoints

Some examples

• /movies/535121
• /search/quentin+tarantino
• /creators/2120
• /user-ratings/912-bart

🧑‍💻 Used by

Web extensions

• Netflix: chrome extension (code)
• Dafilms: chrome extension (code)
• Kviff.tv: chrome extension (code)

Web applications

• bartweb.cz – Last seen section (Firebase function)

Mobile applications

• KinoKlub – Mobile application for AeroFilms (React Native: Android + iOS application)

🔮 Roadmap

Scraping more pages

• [ ] Movies
  • [x] Titles
  • [x] Years
  • [x] Type
  • [x] User rating
  • [x] Color rating
  • [x] Poster
  • [x] Duration
  • [x] Origins
  • [x] Descriptions
  • [x] Genres
  • [x] VOD
  • [x] Tags
  • [x] Premieres
  • [x] Creators
  • [x] Directors
  • [x] Writers
  • [x] Cinematography
  • [x] Music
  • [x] Actors
  • [x] BasedOn
  • [x] Producers
  • [x] Film editors
  • [x] Costume designers
  • [x] Production designers
  • [x] Premieres
  • [x] Related movies
  • [x] Similar movies
  • [x] Trivia
  • [x] Photo from movie (random)
  • [ ] Reviews
  • [ ] OST
• [ ] Search
  • [x] Movies
  • [x] Users
  • [x] TV Series
  • [ ] Creators
• [x] Creators
  • [x] Bio
  • [x] Movies (TODO categories)
• [x] User Ratings
  • [x] Last ratings
  • [x] All pages

🛠️ Development

Developing and debugging library

yarn start

Run demo locally

You can find and modify it in ./demo.ts file

yarn demo

🤝 Contribution

I welcome you to customize this according to your needs ;)

Pull requests for any improvements would be great!

⭐️ Show your support

Give a ⭐️ if this project helped you!

Or if you are brave enough consider making a donation for some 🍺 or 🍵 ;)

🕵️‍♀️ Privacy Policy

I DO NOT STORE ANY DATA. PERIOD.

I physically can't. I have nowhere to store it. I don't even have a server database to store it. So even if Justin Bieber asked nicely to see your data, I wouldn't have anything to show him.

That's why, with node-csfd-api, what happens on your device stays on your device till disappear.

📝 License

Copyright © 2020 – 2025 Lukas Bartak

Proudly powered by nature 🗻, wind 💨, tea 🍵 and beer 🍺 ;)

All contents are licensed under the MIT license.