Data

Tools

Indexes

Applications

Experiments

Open Source Science

internationalshowtimes-api-scripts

International Showtimes API scripts to get data about cinemas, movies, showtimes, etc.

https://github.com/joelparkerhenderson/internationalshowtimes-api-scripts

Science Score: 44.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • ✓
    CITATION.cff file
    Found CITATION.cff file
  • ✓
    codemeta.json file
    Found codemeta.json file
  • ✓
    .zenodo.json file
    Found .zenodo.json file
  • ○
    DOI references
  • ○
    Academic publication links
  • ○
    Committers with academic emails
  • ○
    Institutional organization owner
  • ○
    JOSS paper metadata
  • ○
    Scientific vocabulary similarity
    Low similarity (8.6%) to scientific vocabulary
Last synced: 7 months ago · JSON representation ·

Repository

International Showtimes API scripts to get data about cinemas, movies, showtimes, etc.

Basic Info
  • Host: GitHub
  • Owner: joelparkerhenderson
  • Language: Shell
  • Default Branch: main
  • Homepage:
  • Size: 11.7 KB
Statistics
  • Stars: 4
  • Watchers: 2
  • Forks: 1
  • Open Issues: 0
  • Releases: 0
Created over 8 years ago · Last pushed about 1 year ago
Metadata Files
Readme Code of conduct Citation

README.md

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

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"

API overview

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.

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

Cinema:

  • 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

Movie:

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

Location:

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

Tracking

  • Package: demointernationalshowtimes_api
  • Version: 3.0.0
  • Created: 2017-08-22
  • Updated: 2017-09-02
  • License: GPL
  • Contact: Joel Parker Henderson (joel@joelparkerhenderson.com)

Owner

  • Name: Joel Parker Henderson
  • Login: joelparkerhenderson
  • Kind: user
  • Location: California

Software developer. Technology consultant. Creator of GitAlias.com, NumCommand.com, SixArm.com, and many open source projects.

Citation (CITATION.cff) 

cff-version: 1.2.0
title: Demo of the International Showtimes API
message: >-
  If you use this work and you want to cite it,
  then you can use the metadata from this file.
type: software
authors:
  - given-names: Joel Parker
    family-names: Henderson
    email: joel@joelparkerhenderson.com
    affiliation: joelparkerhenderson.com
    orcid: 'https://orcid.org/0009-0000-4681-282X'
identifiers:
  - type: url
    value: 'https://github.com/joelparkerhenderson/internationalshowtimes-api-scripts/'
    description: Demo of the International Showtimes API
repository-code: 'https://github.com/joelparkerhenderson/internationalshowtimes-api-scripts/'
abstract: >-
  Demo of the International Showtimes API
license: See license file

GitHub Events

Total
  • Push event: 1
Last Year
  • Push event: 1

Committers

Last synced: 8 months ago

All Time
  • Total Commits: 12
  • Total Committers: 1
  • Avg Commits per committer: 12.0
  • Development Distribution Score (DDS): 0.0
Past Year
  • Commits: 1
  • Committers: 1
  • Avg Commits per committer: 1.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Joel Parker Henderson j****l@j****m 12
Committer Domains (Top 20 + Academic)
joelparkerhenderson.com: 1

Issues and Pull Requests

Last synced: 8 months ago

All Time
  • Total issues: 0
  • Total pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Total issue authors: 0
  • Total pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
View more stats
Top Authors
Issue Authors
Pull Request Authors
Top Labels
Issue Labels
Pull Request Labels