# API Cinéma

> REST API (JSON) of cinema showtimes in France and the United States: cinemas, movies matched to TMDB, and showtimes in each cinema's local time, refreshed several times a day from the cinemas' own programmes.

Authentication with an API key (`Authorization: Bearer ac_live_…`), created from the dashboard after sign-up. Every page of the site exists in English (`/en/…`) and French (`/fr/…`).

## API

- [OpenAPI document](https://api.api-cinema.com/openapi.json): every endpoint, parameter and response schema (`?lang=fr` for French)
- [Interactive reference](https://api.api-cinema.com/docs): endpoints, examples, changelog and versions
- [Documentation](https://api-cinema.com/en/docs): the same reference on the website
- [MCP server](https://api.api-cinema.com/mcp): the API as Model Context Protocol tools, with the same API key
- [Status](https://api-cinema.com/en/status): live availability of the API and the site, checked every minute, 90 days of history

## Guides

- [Cinema showtimes API for France](https://api-cinema.com/en/guides/cinema-showtimes-api-france): Get the showtimes of about 2,000 French cinemas as JSON, from Pathé and UGC multiplexes to art-house screens: by city, around a point, by film. Examples with curl and JavaScript.
- [Movie showtimes API for US theaters](https://api-cinema.com/en/guides/movie-showtimes-api-us-theaters): Showtimes of more than 3,000 US movie theaters as JSON (AMC, Regal, Cinemark, Alamo Drafthouse and independents): around a location, by city, by film, with booking links.
- [Allociné API: an alternative for French showtimes](https://api-cinema.com/en/guides/allocine-api-alternative): Allociné no longer offers a public API. How to get the showtimes of French cinemas as JSON instead, and keep using Allociné film ids to match your existing data.
- [Google showtimes API: getting movie times as JSON](https://api-cinema.com/en/guides/google-showtimes-api): Google shows movie times in its results but has no showtimes API. How to get the same data, theaters, films and times, as JSON for France and the United States.
- [Pathé and UGC showtimes API](https://api-cinema.com/en/guides/pathe-ugc-showtimes-api): The showtimes of every Pathé and UGC cinema in France as JSON: versions, IMAX, 4DX and Dolby screenings, rooms and booking links, in one format with the other French cinemas.
- [Fandango API alternative for US movie showtimes](https://api-cinema.com/en/guides/fandango-api-alternative): Fandango has no open API for developers. How to get the showtimes of about 3,000 US theaters as JSON, AMC, Regal, Cinemark and independents, with booking links.

## Tutorials

- [Show a cinema’s showtimes on WordPress](https://api-cinema.com/en/guides/wordpress-cinema-showtimes-shortcode): A small WordPress plugin with a shortcode that displays a cinema’s programme for the coming days, kept up to date and cached, in about 80 lines of PHP.
- [A Discord bot for today’s movie showtimes](https://api-cinema.com/en/guides/discord-bot-movie-showtimes): Build a /showtimes slash command in Node.js with discord.js: today’s films in any French or US city, with cinemas and times, in three small files.
- [Movie showtimes in Next.js: cinema pages with cached API calls](https://api-cinema.com/en/guides/nextjs-movie-showtimes): Build the cinemas of a city and the programme of each cinema with Next.js 16 Server Components, and cache every API answer for an hour with use cache. For France and the US.
- [Movie showtimes API in Python: tonight, a week in CSV, a film near you](https://api-cinema.com/en/guides/python-movie-showtimes-api): Three Python scripts with requests and pandas: what’s on tonight in a city, a week of showtimes exported to CSV, and the next screenings of a film around a point. France and US.
- [A movie showtimes chatbot: tools, RAG on pgvector and a protected API key](https://api-cinema.com/en/guides/movie-showtimes-chatbot): Build an LLM chatbot in Node.js that answers with live showtimes through function calling, finds films from a description with pgvector, and never exposes your API key. Fine-tuning included.
- [Movie showtimes MCP server: ask Claude, Cursor or Copilot what’s on](https://api-cinema.com/en/guides/movie-showtimes-mcp-server): Connect the API Cinéma MCP server to Claude Code, Cursor, VS Code or Claude Desktop in a few lines of config, and get live showtimes for France and the US in plain words. Your API key stays out of the prompt.

## Plans

- Free: free, 150 requests a week, 1 API key; trials and non-commercial projects only
- Starter: €12 / month, 10,000 requests a week, 3 API keys
- Pro: €49 / month, 100,000 requests a week, 10 API keys
- Business: €199 / month, 1,000,000 requests a week, 25 API keys
- Business: also €1990/year; 99.5% monthly availability commitment, support within 1 business day
- Enterprise (custom volume, white label, full export): [quote form](https://api-cinema.com/en#acces)

## Optional

- [Sign up](https://api-cinema.com/en/signup)
- [Terms of use](https://api-cinema.com/en/terms)
- [Terms of sale](https://api-cinema.com/en/sales)
- [Home page](https://api-cinema.com/en)