MovieGraph API

The MovieGraph is a flexible GraphQL powered Movie metadata API that creates powerful insight from a comprehensive database of movies.

Get API Key

Examples

Movie Graph is powered by GraphQL, meaning it only has one endpoint and the developer can make intricate requests and describe the format of the response. The API has data points for movies, actors, directors, producers and movie genres and offers a large list of parameters that can be combined to retrieve insightful information from the database.

If you are unfamiliar with GraphQL, make sure to read their documentation to get the most out of the MovieGraph API.

Basic text search

Request

                  
movies(titleSearch: "Shutter") {
  title
  releaseDate
  imdbScore
  metacriticScore
}
          
                

Response

                  
"movies": [
  {
    "title": "Shutter Island",
    "releaseDate": "2010-02-19",
    "imdbScore": 8.1,
    "metacriticScore": 63
  },
  {
    "title": "Shutter",
    "releaseDate": "2008-03-21",
    "imdbScore": 5.2,
    "metacriticScore": 37
  }
]
          
                

All movies starring a range of actors

Request

                  
movies(starring: [ 
  "Leonardo DiCaprio",
  "Ben Kingsley",
  "Emily Mortimer"
]) {
  title
  releaseDate
  imdbScore
  metacriticScore
  stars {
    name
  }
}
          
                

Response

                  
"movies": [
  {
    "title": "Shutter Island",
    "releaseDate": "2010-02-19",
    "imdbScore": 8.1,
    "metacriticScore": 63,
    "stars": [
      {
        "name": "Emily Mortimer"
      },
      {
        "name": "Patricia Clarkson"
      },
      {
        "name": "Michelle Williams"
      },
      {
        "name": "Mark Ruffalo"
      },
      {
        "name": "Ben Kingsley"
      },
      {
        "name": "Leonardo DiCaprio"
      },
      {
        "name": "Max von Sydow"
      }
    ]
  }
]
          
                

Top 5 grossing movies released in the summer of 2011

Request

                  
movies(
  releaseDateAfter: "2011-07-01",
  releaseDateBefore: "2011-09-01",
  limit: 5,
  order: {field: BOX_OFFICE, ascending: false}
) {
  title
  releaseDate
  imdbScore
  metacriticScore
  boxOfficeString
}
          
                

Response

                  
"movies": [
  {
    "title": "Harry Potter and the Deathly Hallows – Part 2",
    "releaseDate": "2011-07-07",
    "imdbScore": 8.1,
    "metacriticScore": 87,
    "boxOfficeString": "1,342,000,000"
  },
  {
    "title": "Rise of the Planet of the Apes",
    "releaseDate": "2011-08-05",
    "imdbScore": 7.6,
    "metacriticScore": 68,
    "boxOfficeString": "481,800,000"
  },
  {
    "title": "Captain America: The First Avenger",
    "releaseDate": "2011-07-19",
    "imdbScore": 6.9,
    "metacriticScore": 66,
    "boxOfficeString": "370,600,000"
  },
  {
    "title": "The Help",
    "releaseDate": "2011-08-09",
    "imdbScore": 8.1,
    "metacriticScore": 62,
    "boxOfficeString": "216,600,000"
  },
  {
    "title": "Cowboys & Aliens",
    "releaseDate": "2011-07-23",
    "imdbScore": 6,
    "metacriticScore": 50,
    "boxOfficeString": "174,800,000"
  }
]
          
                

Movies directed by Quentin Tarantino, ordered by metacritic score

Request

                  
movies(
  directedBy:"Quentin Tarantino",
  order:{field: METACRITIC_SCORE, ascending: false}
) {
  title
  metacriticScore
}
          
                

Response

                  
"movies": [
  {
    "title": "Pulp Fiction",
    "metacriticScore": 94
  },
  {
    "title": "Django Unchained",
    "metacriticScore": 81
  },
  {
    "title": "Reservoir Dogs",
    "metacriticScore": 79
  },
  {
    "title": "Reservoir Dogs",
    "metacriticScore": 79
  },
  {
    "title": "Grindhouse",
    "metacriticScore": 77
  },
  {
    "title": "Sin City",
    "metacriticScore": 74
  },
  {
    "title": "Inglourious Basterds",
    "metacriticScore": 69
  },
  {
    "title": "Kill Bill Vol. 2",
    "metacriticScore": 69
  },
  {
    "title": "Kill Bill: Volume 1",
    "metacriticScore": 69
  },
  {
    "title": "Jackie Brown",
    "metacriticScore": 64
  },
  {
    "title": "Four Rooms",
    "metacriticScore": null
  }
]
          
                

Longest running film starring Ben Stiller

Request

                  
movies(
  starring: [ "Ben Stiller" ],
  order: {field: RUNNING_TIME, ascending: false},
  limit: 1
) {
  title
  releaseDate
  runningTime
  stars {
    name
  }
}
          
                

Response

                  
"movies": [
  {
    "title": "Keeping the Faith",
    "releaseDate": "2000-04-14",
    "runningTime": "128",
    "stars": [
      {
        "name": "Jenna Elfman"
      },
      {
        "name": "Ben Stiller"
      },
      {
        "name": "Edward Norton"
      },
      {
        "name": "Eli Wallach"
      },
      {
        "name": "Anne Bancroft"
      }
    ]
  }
]
          
                

Animated films that are R rated

Request

                  
movies(
  genre: "Animation",
  certificate: "R"
) {
  title
}
          
                

Response

                  
"movies": [
  {
    "title": "Batman: The Killing Joke"
  },
  {
    "title": "Sausage Party"
  },
  {
    "title": "$9.99"
  },
  {
    "title": "Aqua Teen Hunger Force Colon Movie Film for Theaters"
  },
  {
    "title": "South Park: Bigger, Longer & Uncut"
  },
  {
    "title": "Anomalisa"
  },
  {
    "title": "Hell and Back"
  }
]
          
                

Highest grossing movie released in 2017

Request

                  
movies(
  releaseDateAfter: "2017-01-01",
  releaseDateBefore:"2017-12-31",
  order:{field: BOX_OFFICE, ascending: false},
  limit: 1
) {
  title
  boxOfficeString
}
          
                

Response

                  
"movies": [
  {
    "title": "Star Wars: The Last Jedi",
    "boxOfficeString": "1,332,000,000"
  }
]
          
                

Data

The MovieGraph API exposes a large variety of data points that can be queried simultaneously to create fascinating insights into movies and how they were received. Data points include:

Usage

Once you've received your API Key, making a request is as straightforward as sending the key in your request's authorization header:

Authorization: Api-Key$2b$04$fx0y6Dmx9sf1rnB7Yy6j3eVedOZ7e/ZKe9oeyaQrUJNxkt1UmCJ0u

Direct your requests to /q, with your GraphQL query string as a query parmater. An example to request movies starring John Candy:

https://moviegraph.io/q?query=query{movies(starring:["John Candy"]){title}}

Pricing

Developer

FREE

  • 500 requests a day
  • -
Get API Key

Premium

$10.00/mo

  • 10,000 requests a day
  • Email Support
Get API Key

Have any questions about Movie Graph?