# Cinema City Hungary Films and Showtimes API

> Cinema City Hungary: films now playing and coming soon, 18 cinemas and showtimes per cinema and day

- Vendor: `cinemacityhungaryfilmsandshowt` · version 1.0 · category Movies · tags cinema city api, movie showtimes api, hungary cinema api, films now playing api, cinema listings api, movie schedule api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/cinemacityhungaryfilmsandshowt
- This document: https://apiclay.com/docs/cinemacityhungaryfilmsandshowt.md
- OpenAPI 3.1: https://apiclay.com/api/cinemacityhungaryfilmsandshowt/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `cinemacityhungaryfilmsandshowt`
- Updated: 2026-11-18

## About

## Cinema City Hungary Films and Showtimes API

The film data behind cinemacity.hu, the largest cinema chain in Hungary: the films now playing and coming soon with poster, attributes (2D, 3D, IMAX, 4DX, age rating, genre, dubbed or subtitled) and release date; the 18 cinemas with address, city and coordinates; and for one cinema and day every screening with time, format, language and booking link, plus the films shown.

Data comes from **cinemacity.hu** (https://www.cinemacity.hu). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/cinemas?until=2026-12-31` for cinema ids, then `/showtimes?cinema=1132&amp;date=2026-11-15`; `/now-playing` and `/coming-soon` for the film lists.

### Routes

#### GET `/now-playing` - Now playing
No parameters.

Returns: `body.posters` array: `code`, `featureTitle`, `posterSrc`, `attributes`, `languages`, `dateStarted`, `url`. About 75 KB.

#### GET `/coming-soon` - Coming soon
No parameters.

Returns: `body.posters` array with the same fields for upcoming releases.

#### GET `/cinemas` - Cinemas
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| until | path | string | yes | Last date with screenings to include, `YYYY-MM-DD`. |

Returns: `body.cinemas` array: `id`, `displayName`, `addressInfo` (address, city, postal code), `latitude`, `longitude`, `link`, `blockOnlineSales`.

#### GET `/showtimes` - Showtimes
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| cinema | path | string | yes | Cinema `id` from `/cinemas`, e.g. `1132` (Arena, Budapest). |
| date | path | string | yes | Day, `YYYY-MM-DD`. |

Returns: `body.films` (`id`, `name`, `length`, `posterLink`, `releaseYear`, `attributeIds`) and `body.events` (`filmId`, `eventDateTime`, `attributeIds`, `languages`, `auditorium`, `soldOut`, `bookingLink`).

### Caveats

- Film titles follow the site (Hungarian or English); prices are only on the booking pages.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by cinemacity.hu.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /now-playing — Now playing
- Gateway: `GET https://api.apiclay.com/v1/api/cinemacityhungaryfilmsandshowt/now-playing`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /coming-soon — Coming soon
- Gateway: `GET https://api.apiclay.com/v1/api/cinemacityhungaryfilmsandshowt/coming-soon`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /cinemas — Cinemas
- Gateway: `GET https://api.apiclay.com/v1/api/cinemacityhungaryfilmsandshowt/cinemas`
- Public query params: `until` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /showtimes — Showtimes
- Gateway: `GET https://api.apiclay.com/v1/api/cinemacityhungaryfilmsandshowt/showtimes`
- Public query params: `cinema` (string, required), `date` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/cinemacityhungaryfilmsandshowt/now-playing" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
