# CSFD Czech Movie Reviews & Ratings Scraper (ČSFD) (`scrapebench/csfd-movie-reviews-scraper`) Actor

Scrape ČSFD, the Czech-Slovak film database: user reviews with stars, film and series details with the Czech audience rating, top charts and filmographies. Czech, Slovak and original titles on one row.

- **URL**: https://apify.com/scrapebench/csfd-movie-reviews-scraper.md
- **Developed by:** [ScrapeBench](https://apify.com/scrapebench) (community)
- **Categories:** Social media, Other
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.002 / review

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## CSFD Czech Movie Reviews & Ratings Scraper (ČSFD)

### Pain points

- ČSFD is where Czech and Slovak audiences rate and review films, but it has no public API or export.
- IMDb and Rotten Tomatoes scores say little about how a title lands with Czech and Slovak viewers.
- Copying reviews, ratings and titles page by page is slow, and the Czech, Slovak and original names sit in different places.

### What we solve

- Reviews mode returns each film's user reviews: author, 0-5 stars (0 = ČSFD's 'trash' rating), full text and posting date.
- Film mode returns one row per film, series, season or episode: Czech, Slovak and original titles, ČSFD rating %, ratings and review counts, genres, countries, director, writers, full cast and crew, plot, poster and the streaming services listed.
- Chart mode returns ČSFD's top charts (best, favourite, most controversial and worst movies or series) with rank, rating % and ratings count, up to about 950 rows each.
- Person mode returns an actor's or director's profile with the whole filmography, by role and year.

### Summary

ČSFD (csfd.cz) is the Czech and Slovak equivalent of IMDb, where local audiences rate films and write their reviews in Czech and Slovak. This actor turns it into rows. List film IDs or links and get their user reviews with stars, text and date; switch the mode to get film and series details with the ČSFD audience rating, the full top charts, or a person's complete filmography. Every film row carries the Czech, Slovak and original titles together, so it joins cleanly to your own catalogue. Built for streaming and cinema marketers, film distributors entering the CZ/SK market, recommender and review-analytics teams.

### Who it's for

- Streaming services and cinema chains marketing to Czech and Slovak audiences
- Film distributors and sales agents judging a title for the CZ/SK market
- Recommender, sentiment and review-analytics teams who need Czech-language reviews with star ratings
- Film journalists, researchers and data teams tracking Czech audience taste

### How to use

Set the input, run the actor, and collect results from the run's dataset (export to JSON/CSV/Excel, or pull via the Apify API). Example input:

```json
{
  "mode": "reviews",
  "films": [
    "https://www.csfd.cz/film/2294-vykoupeni-z-veznice-shawshank/"
  ],
  "maxReviews": 50
}
```

See **Inputs** below for every available field.

### What you get

One row per record:

| Field | Description |
|---|---|
| `film_id / film_title` | Reviews: the film's ČSFD id and Czech title |
| `author / author_id` | Reviews: the reviewer's ČSFD username and user id |
| `rating_stars` | Reviews: the reviewer's rating, 0 (trash) to 5 stars |
| `text / review_date` | Reviews: the full review text and the date it was posted |
| `title / title_original / title_sk / other_titles` | Film: Czech, original and Slovak titles, plus every title ČSFD lists with its country |
| `type` | Film: film, series, season, episode, tv_film, ... |
| `rating_percent / rating_count / review_count` | ČSFD audience rating (0-100 %) and how many ratings and reviews it rests on |
| `year / duration_minutes / genres / countries` | Film: release year, running time, genres and countries of origin (Czech names) |
| `directors / writers / cast / crew` | Film: credits; crew lists every role with names and ČSFD person ids |
| `plot / poster / where_to_watch` | Film: plot summary (Czech), poster URL and the streaming services ČSFD lists |
| `series_id / episodes` | Series: its seasons or episodes; episodes and seasons: the parent series id |
| `chart / rank` | Chart rows: which chart and the position in it |
| `name / birth_date / birth_place / roles / filmography` | Person: profile and every credit with role, category, year and film id |
| `url` | The csfd.cz page: review permalink, film, or person |

Sample:

```json
{
  "film_id": 2294,
  "film_title": "Vykoupen\u00ed z v\u011bznice Shawshank",
  "review_id": 10145,
  "author": "golfista",
  "author_id": 95,
  "rating_stars": 5,
  "text": "Na velmi o\u0161emetnou a t\u011b\u017eko zodpov\u011bditelnou ot\u00e1zku \"kter\u00fd film je podle v\u00e1s nejlep\u0161\u00ed\", mi dal do \u00fast t\u00edmhle d\u00edlem Frank Darabont odpov\u011b\u010f, za kterou se opravdu nebudu styd\u011bt. ...",
  "review_date": "2003-02-14",
  "url": "https://www.csfd.cz/film/2294-vykoupeni-z-veznice-shawshank/recenze/?review=10145"
}
```

### Inputs

| Field | Required | Type | Default | Description |
|---|---|---|---|---|
| `mode` | no | string | `"reviews"` | reviews: user reviews of the films you list (author, stars, text, date). film: one detail row per film, series, season or episode (Czech, Slovak and original titles, rating, genres, cast, plot, where to watch). chart: ČSFD top charts (best, favourite, most controversial, worst movies or series). person: an actor's or director's profile with the whole filmography. |
| `films` | no | array | `["https://www.csfd.cz/film/2294-vykoupeni-z-veznice-shawshank/"]` | csfd.cz film IDs or links, one per line: 2294, https://www.csfd.cz/film/2294-vykoupeni-z-veznice-shawshank/ or a csfd.sk link. Series, seasons and episodes work too. |
| `film` | no | string | — | One film ID or link; added to 'Films'. Kept for saved tasks and API callers. |
| `maxReviews` | no | integer | `50` | Reviews mode: cap PER FILM, in the order csfd.cz lists them (about 10 per page). A film can have fewer; the run log says how many it had. |
| `charts` | no | array | `[]` | One or more of: movies-best, movies-favourite, movies-controversial, movies-worst, series-best, series-favourite, series-controversial, series-worst, or a csfd.cz /zebricky/ link. |
| `chart` | no | string | — | One chart; added to 'Charts'. |
| `maxResults` | no | integer | `100` | Chart mode: rows per chart, from rank 1. ČSFD's charts end at about rank 950. |
| `people` | no | array | `[]` | csfd.cz person IDs or links, one per line: 92 or https://www.csfd.cz/tvurce/92-morgan-freeman/. |
| `person` | no | string | — | One person ID or link; added to 'People'. |
| `startUrls` | no | array | `[]` | Paste csfd.cz links of any kind: film links go to 'Films', /tvurce/ links to 'People', /zebricky/ links to 'Charts'. Which of them are used depends on the mode. |
| `proxyConfiguration` | no | object | `{"useApifyProxy": false}` | Off by default: csfd.cz answers Apify's own servers. Turn on only if a run says csfd.cz did not answer. |

### Pricing (Pay Per Event)

You pay per result (`review`) — **no charge for empty runs**. Example: **1000 reviews** at *$0.002/result* ≈ **$2.00**.

$0.002 per review, $0.003 per film, series, episode or person row, $0.001 per top-chart row. Only delivered rows are charged; unknown ids and notices are free.

### Use cases

- Audience check: the ČSFD rating, ratings count and written reviews for every title in a release slate.
- Sentiment analysis: Czech and Slovak review text with the reviewer's own 0-5 star rating as the label.
- Catalogue matching: Czech, Slovak and original titles on one row to map your catalogue to local names.
- Market maps: the full ČSFD top charts for movies and series, with ranks, ratings and genres.
- Talent research: an actor's or director's complete filmography with years and roles.

### Why this actor

- Czech audience data: the ČSFD rating % and ratings count, not a global score.
- Czech, Slovak and original titles together on every film row.
- Four jobs in one actor: reviews, film and series details, top charts and filmographies.
- Paste ids or any csfd.cz link (film, series, episode, person or chart); csfd.sk links work too.
- A free notice instead of a silent empty result when an id does not exist or the site does not answer.

### Limitations & updates

Covers what ČSFD shows publicly: no logged-in data, no site search (look titles up by id, link or chart), no per-user rating lists. Reviews, plots, genres and countries are in Czech or Slovak. Charts end at about rank 950. The actor reads one page at a time with a pause between pages, so 1,000 reviews take a few minutes.

### FAQ

**Which films can I scrape?**

Any film, series, season or episode on csfd.cz: give its numeric id (the number in its link) or paste the link. csfd.sk links work too.

**How many reviews does a film return?**

Up to maxReviews per film (default 50), in the order csfd.cz lists them, about 10 per page. Popular films have thousands; the run stops at your cap or at the last review.

**What does rating_stars 0 mean?**

ČSFD's lowest grade, 'odpad' (trash). 1 to 5 are stars.

**Is the text in English?**

No. Reviews, plots, genres and countries are in Czech or Slovak, as ČSFD publishes them. Titles come in Czech, Slovak and the original language.

**Can I search ČSFD by title?**

Not in this version: use film ids or links, or start from a top chart. The chart and film rows carry the ids you need for the reviews mode.

**How am I charged?**

$0.002 per review, $0.003 per film, series, episode or person row, $0.001 per chart row. Unknown ids and notices are free.

### Guides & use cases

Written up on **[scrapebench.dev](https://scrapebench.dev)** — the bench that runs and verifies this actor against the live source every night:

- **How-to:** [How to run CSFD Czech Movie Reviews & Ratings Scraper (ČSFD)](https://scrapebench.dev/guides/how-to-csfd-movie-reviews-scraper/)
- **Use case:** [ČSFD best movies chart with ratings](https://scrapebench.dev/use-cases/csfd-best-movies-chart/)

More actors, coverage and nightly verification results: **[scrapebench.dev](https://scrapebench.dev)**

### Works with AI assistants (MCP)

Callable as an MCP tool, so Claude, Cursor, VS Code Copilot and other MCP clients can run it directly. Grab the config from the [MCP tab](https://apify.com/scrapebench/csfd-movie-reviews-scraper/api/mcp) on this page — Apify hosts the server and keeps that snippet current, and OAuth signs you in on first connect, so no API token goes in your config file.

Then just ask:

> "Get the first 50 ČSFD user reviews of The Shawshank Redemption (https://www.csfd.cz/film/2294-vykoupeni-z-veznice-shawshank/) with each reviewer's star rating."

Switch mode to film, chart or person for title details, the top charts or a filmography; chart rows give you the film ids for the reviews mode. Runs started this way bill exactly like any other run.

### Data & lawful use

This actor collects publicly available information that ČSFD (Česko-Slovenská filmová databáze, csfd.cz) publishes for public
lookup — licence records, business listings and the contact details professionals list there.
Some of it identifies individuals (sole proprietors, licence holders, agents), so treat any
names, phone numbers and emails in your results as personal data.

When you run this actor, you decide what is collected and what it is used for, so you are the
controller of that data and we act only as your processor (Apify Standard Actor Contract).
You need a lawful basis for your use, must honour opt-out and deletion requests, and must
follow the marketing rules that apply to you (CAN-SPAM, TCPA, GDPR, CCPA and similar).
Don't use the output for unsolicited bulk messaging, for screening covered by the FCRA, or
for anything the source's own terms forbid.

Your results are stored in your own Apify account. We don't keep a copy of your results and
don't sell or share them.

### Disclaimer

This is an independent tool. It is not affiliated with, endorsed by or sponsored by
ČSFD (Česko-Slovenská filmová databáze, csfd.cz). Names and marks are used only to describe the data source. Records are
provided as published by the source and may be out of date or incomplete. For anything
consequential (hiring, a permit, a legal decision), confirm the record with the issuing
agency. You are responsible for making sure your use complies with applicable law and the
source's terms.

### Need help?

Open an issue on this actor's **Issues** tab and we'll respond there. Bug reports, missing
fields and feature requests are all welcome. Guides and examples: [scrapebench.dev](https://scrapebench.dev).

If you are a person named in this data and want your record removed from our copy, email
apify-help@scrapebench.dev; the source agency remains the official record.

Your run may be used to improve our services. If something looks off, or you want this actor to fit your use better, please share your run data with us: [Apify Console → Settings → Security → Share run data with developers](https://console.apify.com/settings/security). It lets us see exactly what went wrong and keep improving the actor.

If this actor saved you time, a short review on its Store page helps other buyers find it.

# Actor input Schema

## `mode` (type: `string`):

reviews: user reviews of the films you list (author, stars, text, date). film: one detail row per film, series, season or episode (Czech, Slovak and original titles, rating, genres, cast, plot, where to watch). chart: ČSFD top charts (best, favourite, most controversial, worst movies or series). person: an actor's or director's profile with the whole filmography.

## `films` (type: `array`):

csfd.cz film IDs or links, one per line: 2294, https://www.csfd.cz/film/2294-vykoupeni-z-veznice-shawshank/ or a csfd.sk link. Series, seasons and episodes work too.

## `film` (type: `string`):

One film ID or link; added to 'Films'. Kept for saved tasks and API callers.

## `maxReviews` (type: `integer`):

Reviews mode: cap PER FILM, in the order csfd.cz lists them (about 10 per page). A film can have fewer; the run log says how many it had.

## `charts` (type: `array`):

One or more of: movies-best, movies-favourite, movies-controversial, movies-worst, series-best, series-favourite, series-controversial, series-worst, or a csfd.cz /zebricky/ link.

## `chart` (type: `string`):

One chart; added to 'Charts'.

## `maxResults` (type: `integer`):

Chart mode: rows per chart, from rank 1. ČSFD's charts end at about rank 950.

## `people` (type: `array`):

csfd.cz person IDs or links, one per line: 92 or https://www.csfd.cz/tvurce/92-morgan-freeman/.

## `person` (type: `string`):

One person ID or link; added to 'People'.

## `startUrls` (type: `array`):

Paste csfd.cz links of any kind: film links go to 'Films', /tvurce/ links to 'People', /zebricky/ links to 'Charts'. Which of them are used depends on the mode.

## `proxyConfiguration` (type: `object`):

Off by default: csfd.cz answers Apify's own servers. Turn on only if a run says csfd.cz did not answer.

## Actor input object example

```json
{
  "mode": "reviews",
  "films": [
    "https://www.csfd.cz/film/2294-vykoupeni-z-veznice-shawshank/"
  ],
  "maxReviews": 50,
  "charts": [],
  "maxResults": 100,
  "people": [],
  "startUrls": [],
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `results` (type: `string`):

One row per review, film, chart entry or person.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "reviews",
    "films": [
        "https://www.csfd.cz/film/2294-vykoupeni-z-veznice-shawshank/"
    ],
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapebench/csfd-movie-reviews-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "reviews",
    "films": ["https://www.csfd.cz/film/2294-vykoupeni-z-veznice-shawshank/"],
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("scrapebench/csfd-movie-reviews-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "reviews",
  "films": [
    "https://www.csfd.cz/film/2294-vykoupeni-z-veznice-shawshank/"
  ],
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call scrapebench/csfd-movie-reviews-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapebench/csfd-movie-reviews-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/4tgbzqLCsNqacob52/builds/qmTvx2cFw490r0wAR/openapi.json
