Cinema showtimes API

Get showtimes for a movie

GET /3/movie/{movie_id}/showtimes?country=US returns the cinemas that screen one movie in one country, each with a list of screenings. country is a 2 letter code. Without it, results stays empty and you get only per-country counts. Coverage varies by country and title, and an empty results array means nothing is known for that pair.

You get the cinema name, chain, address and time zone, and for each screening the start time, auditorium, formats, tags and a booking link where known. Only screenings from today on are returned. The reply describes screenings. It is not a ticketing service.

What data you get

Fields in the showtimes reply:

A reply holds at most 1,500 screenings, ordered by cinema and then start time.

Start in 3 steps

1. Open pricing and choose a plan. Showtimes are included in every plan.
2. Create a key in your account dashboard.
3. Request /3/movie/{movie_id}/showtimes with a country code, and pass the key in api_key or as a Bearer header.

Example request

The bash sample reads showtimes for Fight Club (id 550) in Russia, where amodb has screenings for it today. The JS sample takes the first five movies of the Russian now_playing list and prints up to three screenings per cinema, or a note when none are known.

curl -s "https://api.amodb.dev/3/movie/550/showtimes?country=RU" \
  -H "Authorization: Bearer $AMODB_KEY"

const BASE = 'https://api.amodb.dev/3';
const headers = { Authorization: `Bearer ${process.env.AMODB_KEY}` };

async function get(path, params = {}) {
  const res = await fetch(`${BASE}${path}?${new URLSearchParams(params)}`, { headers });
  if (!res.ok) throw new Error(`amodb returned ${res.status} for ${path}`);
  return res.json();
}

const country = 'RU';
const playing = await get('/movie/now_playing', { region: country, page: 1 });

for (const movie of playing.results.slice(0, 5)) {
  const { results } = await get(`/movie/${movie.id}/showtimes`, { country });
  if (results.length === 0) {
    console.log(`${movie.title}: no showtimes known`);
    continue;
  }
  for (const cinema of results) {
    const times = cinema.showtimes
      .slice(0, 3)
      .map((s) => `${s.start.slice(5, 10)} ${s.start.slice(11, 16)} ${s.formats.join('/')}`)
      .join(', ');
    console.log(`${movie.title} at ${cinema.name}, ${cinema.city}: ${times}`);
  }
}

Trimmed response for country=RU: the first cinema with 2 of its screenings.

{
  "id": 550,
  "country": "RU",
  "results": [
    {
      "id": 1114,
      "name": "Мираж Синема НА БОЛЬШОМ",
      "chain": {
        "key": "mirage-ru",
        "name": "Мираж Синема"
      },
      "city": "Санкт-Петербург",
      "region": null,
      "address": "Большой пр. П.С., д. 35А",
      "postal_code": null,
      "country": "RU",
      "timezone": "Europe/Moscow",
      "latitude": null,
      "longitude": null,
      "phone": null,
      "url": "https://www.mirage.ru/spb/cinema/1/",
      "showtimes": [
        {
          "date": "2026-10-18",
          "start": "2026-10-18T21:40",
          "end": null,
          "auditorium": null,
          "formats": [
            "2D"
          ],
          "tags": [],
          "audio": null,
          "subtitles": null,
          "language": null,
          "price": null,
          "currency": null,
          "prices": null,
          "booking_url": "https://www.mirage.ru/ticket_new/aca7b114-d587-4fc5-9df6-28568e8fa9b3/",
          "sold_out": false
        },
        {
          "date": "2026-10-19",
          "start": "2026-10-19T22:20",
          "end": null,
          "auditorium": "Зал №4",
          "formats": [
            "2D"
          ],
          "tags": [],
          "audio": null,
          "subtitles": null,
          "language": null,
          "price": null,
          "currency": null,
          "prices": null,
          "booking_url": "https://www.mirage.ru/ticket_new/0c32e190-890a-4c81-a754-3300fefc4d5e/",
          "sold_out": false
        }
      ]
    }
  ],
  "countries": [
    {
      "country": "RU",
      "name": "Russia",
      "venues": 2,
      "cities": 1,
      "showtimes": 7,
      "first_day": "2026-10-18",
      "last_day": "2026-10-21"
    }
  ]
}

Coverage and empty results

Cinema data is not available for every country or title. Plan your interface around that.

An empty array is not an error and not a claim that the movie is missing from cinemas. It means no screening data is known. See errors for the full body format.

Build a listings page for current releases

Combine two endpoints. The list tells you which movies are current, and showtimes fill in the screenings.

One page of 20 movies costs 21 requests. A reply for a big release can be several hundred kilobytes, because it holds up to 1,500 screenings. On the 20 requests per minute plan that is a full minute of budget, so fetch in a background job and serve visitors from your stored copy. The 40 and 120 requests per minute plans fit the same job with room to spare. See rate limits for the window and the headers, and trending and lists for the other list endpoints.

Keep your copy fresh

Showtimes change by the day, unlike movie details. Store each reply with its movie id, country and fetch time. A TTL of 30 minutes up to a few hours works for most listings pages, and screenings that already started can be hidden by comparing start with the current time in the cinema's timezone. Because start has no offset, do not shift it into the visitor's time zone.

How it compares

Pricing

Prepaid plans run for 1, 3, 6, 12 or 24 months, with 0, 10, 20, 30 or 40 percent off for longer ones. Nothing renews automatically. The plans allow 20, 40 and 120 requests per minute and each includes showtimes along with all other data. A listings page that refreshes every 30 minutes for a few countries fits the smallest rate. There is no free tier. Choose a plan on pricing.