cineamo-showtimes

Find Cinemas

Cinemas in a city or near coordinates, with address, homepage and the cinemaId needed for get_showtimes. By default only cinemas that actually have a showing in the given window are returned. Pass movieId (from search_catalog) to get exactly the cinemas screening that film — answer "which cinemas show <film>" with this rather than with get_showtimes, which covers only 12 venues at a time. Returns 25 venues per page (up to 100 with perPage); every city in the network except Berlin, which has 80,

Get Cinema

Address, phone, homepage and timezone of one cinema by its cinemaId.

Get Showtimes

Real showtimes with booking links for cinemas in the Cineamo network (mainly Germany, Austria, Switzerland). Give a city, a set of cinemaIds, or coordinates. Answers "what is playing tonight in <city>", "when does <film> run at <cinema>" (pass movieId from search_catalog), and "what is on this week". For a format or language — IMAX, 3D, Dolby, original version — pass the matching flag rather than filtering the result yourself: one page holds 100 screenings and the page is cut before filtering, s

Search Catalog

Resolve a free-text term into ids: films (use entityId as movieId), cinemas (use entityId as cinemaId) and cities. Call this first when a title or city name is fuzzy, misspelled or in another language than the local one. Results are ranked by relevance, 10 per page (up to 50 with perPage); hasMore says whether a further page exists, but a better query almost always beats one.