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 41514 $ 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" 20345 $ 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"
The API provides URIs that look like this:
http://api.internationalshowtimes.com/v4/showtimes/ ?lang=en &location=40.7527,73.9772 &distance=5
The URI is a typical RESTful method with these pieces:
- Entry point "http://api.internationalshowtimes.com"
- Semantic version number "v4"
- RESTful method "showtimes"
- Query string with filters.
The API uses an API key that is typically sent as an HTTP header.
Get your own API key:
Go to International Showtimes
Request an API key for one of the free 30-day trial plans.
These demo scripts use a convention of storing the API key in a shell environment variable, like this:
- 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 (firstname.lastname@example.org)