International Showtimes API scripts to get data about cinemas, movies, showtimes, etc.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Demo of the International Showtimes API

This demo connects to the International Showtimes API to get data about cinemas, movies, showtimes, etc.

To start, please see International Showtimes API


Examples of using these scripts:

$ internationalshowtimes-get-cinemas-by-location 40.756359 -73.988873
... JSON list of cinemas near latitude and longitude 
    of Grand Central Station in New York City

$ internationalshowtimes-get-cinema-id-by-name-and-location "AMC Empire 25" 40.756359 -73.988873

$ internationalshowtimes-get-movies-by-title "Spider-Man"
... JSON list of movies that have Spider-Man in the title

$ internationalshowtimes-get-movie-id-by-title "Spider-Man: Homecoming"

$ internationalshowtimes-get-showtimes-by-cinema-id-and-movie-id 41514 20345
... JSON list of showtimes at cinema id 41514 and movie id 20345,
    meaing cinema "AMC Empire 25" and movie "Spider-Man: Homecoming"

API overview

The API provides URIs that look like this:

The URI is a typical RESTful method with these pieces:

The API uses an API key that is typically sent as an HTTP header.

API setup

Get your own API key:

  1. Go to International Showtimes

  2. Request an API key for one of the free 30-day trial plans.

  3. These demo scripts use a convention of storing the API key in a shell environment variable, like this:

    export INTERNATIONALSHOWTIMES_API_KEY="a1b2c3d4e5f6g7h8i9j0" 

Sample data


  • AMC Empire 25
  • New York City
  • Street address: 234 W 42nd St, New York, NY, 10036, US
  • Latitude: 40.756359
  • Longitude: -73.988873
  • Location is within 2 kilometers of Grand Central Station
  • International Showtimes API: cinema id 41514


  • Spider-Man: Homecoming
  • International Showtimes API: movie id 20345


  • Grand Central Station
  • New York City
  • Street address: 89 E 42nd St, New York, NY, 10017, US
  • Latitude: 40.7527
  • Longitude: -73.9772


  • Package: demo_international_showtimes_api
  • Version: 3.0.0
  • Created: 2017-08-22
  • Updated: 2017-09-02
  • License: GPL
  • Contact: Joel Parker Henderson (