Skip to main content
The cinema() method retrieves current cinema showtimes for a specific district and time period. It returns information about cinemas, their locations, and grouped film screenings by date.

Method Signature

csfd.cinema(
  district: number | string,
  period: CSFDCinemaPeriod,
  options?: CSFDOptions
): Promise<CSFDCinema[]>

Parameters

district
number | string
required
District ID or code. Common values:
  • 1 - Praha (Prague)
  • 2 - Brno
  • 3 - Ostrava
  • See ČSFD for other district codes
period
CSFDCinemaPeriod
required
Time period for showtimes:
  • 'today' - Today’s screenings
  • 'tomorrow' - Tomorrow’s screenings
  • 'weekend' - This weekend
  • 'week' - This week
  • 'month' - This month
options
CSFDOptions
Optional request configuration

Return Type

CSFDCinema[]
array
Array of cinema objects with screenings

Usage Examples

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

// Get today's showtimes in Prague
const cinemas = await csfd.cinema(1, 'today');

cinemas.forEach(cinema => {
  console.log(`${cinema.name} - ${cinema.city}`);
  cinema.screenings.forEach(screening => {
    console.log(`  ${screening.date}:`);
    screening.films.forEach(film => {
      console.log(`    ${film.title}: ${film.showTimes.join(', ')}`);
    });
  });
});
[
  {
    "id": 12345,
    "name": "Cinema City Flora",
    "city": "Praha",
    "url": "https://www.csfd.cz/kino/12345-cinema-city-flora/",
    "coords": {
      "lat": 50.0755,
      "lng": 14.4378
    },
    "screenings": [
      {
        "date": "Dnes",
        "films": [
          {
            "id": 535121,
            "title": "Na špatné straně",
            "url": "https://www.csfd.cz/film/535121",
            "meta": ["subtitles"],
            "showTimes": ["18:00", "20:30", "22:45"]
          },
          {
            "id": 678910,
            "title": "Dune: Part Two",
            "url": "https://www.csfd.cz/film/678910",
            "meta": ["3D", "subtitles"],
            "showTimes": ["17:00", "20:00"]
          }
        ]
      },
      {
        "date": "Zítra",
        "films": [
          {
            "id": 535121,
            "title": "Na špatné straně",
            "url": "https://www.csfd.cz/film/535121",
            "meta": ["dubbing"],
            "showTimes": ["19:00", "21:30"]
          }
        ]
      }
    ]
  }
]

Time Periods

The period parameter accepts the following values:
  • 'today' - Shows screenings for today only
  • 'tomorrow' - Shows screenings for tomorrow
  • 'weekend' - Shows screenings for the upcoming weekend (Friday-Sunday)
  • 'week' - Shows screenings for the current week
  • 'month' - Shows screenings for the entire month

Screening Metadata

The meta array contains information about the screening format and language:
  • '3D' - 3D screening
  • 'dubbing' - Czech/Slovak dubbing
  • 'subtitles' - Original language with subtitles
Other values may appear depending on what ČSFD provides.
Cinema data is real-time and reflects current ČSFD information. Showtimes may change without notice.
Use the geographic coordinates to display cinemas on a map. This is particularly useful for building cinema finder applications.
Some smaller cinemas may not have complete coordinate data. Always check if coords exists before using it.

Build docs developers (and LLMs) love