Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time
February 26, 2022 00:19
April 7, 2023 15:32
April 7, 2023 15:32
February 25, 2022 22:58
January 10, 2020 00:08
February 25, 2022 23:46
August 29, 2022 20:55
February 26, 2022 00:19


Latest Stable Version CircleCI Coverage Status

PHP IMDB-API that can fetch film data and search results.


Install the latest version using composer.

$ composer require hmerritt/imdb-api


// Assuming you installed from Composer:
require "vendor/autoload.php";
use hmerritt\Imdb;

$imdb = new Imdb;

// Search imdb
// -> returns array of films and people found

// Get film data
// -> returns array of film data (title, year, rating...)


Name Type Default Value Description
curlHeaders array ['Accept-Language: en-US,en;q=0.5'] Custom headers can be passed to cURL when fetching the IMDB page
cache bool true Caches film data to speed-up future requests for the same film
techSpecs bool true Loads a films technical specifications (this will take longer as it makes a separate request)
category string all What category to search for (films tt, people nm or companies co)
$imdb = new Imdb;

//  Options are passed as an array as the second argument
//  These are the default options
$imdb->film("tt0816692", [
    'cache'        => true,
    'curlHeaders'  => ['Accept-Language: en-US,en;q=0.5'],
    'techSpecs'    => true,

$imdb->search("Interstellar", [
    'category'     => 'all',
    'curlHeaders'  => ['Accept-Language: en-US,en;q=0.5'],

Best Match

If you do not know the imdb-id of a film, a search string can be entered. This will search imdb and use the first result as the film to fetch data for.

Note that this will take longer than just entering the ID as it needs to first search imdb before it can get the film data.

// Searches imdb and gets the film data of the first result
// -> will return the film data for 'Apocalypse Now'


Film Data

- Title
- Genres
- Year
- Length
- Plot
- Rating
- Rating Votes (# of votes)
- Poster
- Trailer
    - id
    - link
- Cast
    - actor name
    - actor id
    - character
    - avatar
    - avatar_hq (high quality avatar)
- Technical Specs


Search IMDB to return an array of films, people and companies

- Films
    - id
    - title
    - image
- People
    - id
    - name
    - image
- Companies
    - id
    - name
    - image


All dependencies are managed automatically by composer.