IMDb API Documentation

Documentation and Online Test

Enter your API Key for testing APIs.

Register on site to get free API Key.


NOTE:
  • All APIs are not case sensitive. You can using Search or sEArcH !
  • If you are working with non-English languages, the lang parameter is important for the following actions: Title, Report, Subtitles, Wikipedia, Name

Search

Search is same as SearchTitle, search into all titles. It is recommended to use SearchMovie or SearchSeries to search for a movie or series.

ParametersRequiredDescription
langOptionalLanguage of results. Default value is "en" (English). Language change is not important in search action.
apiKeyRequiredAPI Key required for all API calls. Register on site to get free API Key.
expressionRequiredExpression for search. For examples "Leon The Professional" or "Inception". You can also search with year (ex: "Inception 2010")
RESULTSearchData

Examples

Test

https://imdb-api.com/en/API/Search/k_12345678/Inception 2010

Search into all titles. It is recommended to use SearchMovieMovie or SearchMovieSeries to SearchMovie for a movie or series.

ParametersRequiredDescription
langOptionalLanguage of results. Default value is "en" (English). Language change is not important in search action.
apiKeyRequiredAPI Key required for all API calls. Register on site to get free API Key.
expressionRequiredExpression for search. For examples "Leon The Professional" or "Inception". You can also SearchTitle with year (ex: "Inception 2010")
RESULTSearchData

Examples

Test

https://imdb-api.com/en/API/SearchTitle/k_12345678/Inception 2010

Search into all Movies.

ParametersRequiredDescription
langOptionalLanguage of results. Default value is "en" (English). Language change is not important in search action.
apiKeyRequiredAPI Key required for all API calls. Register on site to get free API Key.
expressionRequiredExpression for search. For examples "Leon The Professional" or "Inception". You can also SearchMovie with year (ex: "Inception 2010")
RESULTSearchData

Examples

Test

https://imdb-api.com/en/API/SearchMovie/k_12345678/Inception 2010

Search into all Series TVs.

ParametersRequiredDescription
langOptionalLanguage of results. Default value is "en" (English). Language change is not important in search action.
apiKeyRequiredAPI Key required for all API calls. Register on site to get free API Key.
expressionRequiredExpression for search. For examples "Leon The Professional" or "Inception". You can also SearchSeries with year (ex: "Inception 2010")
RESULTSearchData

Examples

Test

https://imdb-api.com/en/API/SearchSeries/k_12345678/lost

Search into all people.

ParametersRequiredDescription
langOptionalLanguage of results. Default value is "en" (English). Language change is not important in search action.
apiKeyRequiredAPI Key required for all API calls. Register on site to get free API Key.
expressionRequiredExpression for search. Searching people by name (Actors, Actresses, Directors, Writers and ...)
RESULTSearchData

Examples

Test

https://imdb-api.com/en/API/SearchName/k_12345678/Jean Reno

Search into all TV Episode titles.

ParametersRequiredDescription
langOptionalLanguage of results. Default value is "en" (English). Language change is not important in search action.
apiKeyRequiredAPI Key required for all API calls. Register on site to get free API Key.
expressionRequiredExpression for search.
RESULTSearchData

Examples

Test

https://imdb-api.com/en/API/SearchEpisode/k_12345678/London

Search into all companies.

ParametersRequiredDescription
langOptionalLanguage of results. Default value is "en" (English). Language change is not important in search action.
apiKeyRequiredAPI Key required for all API calls. Register on site to get free API Key.
expressionRequiredExpression for search.
RESULTSearchData

Examples

Test

https://imdb-api.com/en/API/SearchCompany/k_12345678/warner bross

Search into all keywords.

ParametersRequiredDescription
langOptionalLanguage of results. Default value is "en" (English). Language change is not important in search action.
apiKeyRequiredAPI Key required for all API calls. Register on site to get free API Key.
expressionRequiredExpression for search.
RESULTSearchData

Examples

Test

https://imdb-api.com/en/API/SearchKeyword/k_12345678/gun

Search into all items (Movies, Series TVs, TV Episodes, Names, Companies, Keywords and more).

ParametersRequiredDescription
langOptionalLanguage of results. Default value is "en" (English). Language change is not important in search action.
apiKeyRequiredAPI Key required for all API calls. Register on site to get free API Key.
expressionRequiredExpression for search.
RESULTSearchData

Examples

Test

https://imdb-api.com/en/API/SearchAll//k_12345678Inception 2010

Title

Get Movies or Series TV information.

ParametersRequiredDescription
langOptionalLanguage of results. Default value is "en" (English). PlotLocal and WikipediaPlot properties has been change by your selected language.
apiKeyRequiredAPI Key required for all API calls. Register on site to get free API Key.
idRequiredA valid IMDb Id. Id started withs tt.
optionsOptionalOptions to get more information about: FullActor, FullCast, Posters, Images, Trailer, Ratings, Wikipedia.
RESULTTitleData

Tips: You can combine options with apiKey. ex: "..../tt1234567/FullCast,Images,k_1234567"

Examples

Test

Options
https://imdb-api.com/en/API/Title/k_12345678/tt1375666

Generate report from Movie or Series TV as PNG image file.

ParametersRequiredDescription
langOptionalLanguage of results. Default value is "en" (English). PlotLocal and WikipediaPlot properties has been change by your selected language.
apiKeyRequiredAPI Key required for all API calls. Register on site to get free API Key.
idRequiredA valid IMDb Id. Id started withs tt.
optionsOptionalOptions to get more information about: FullActor, FullCast, Ratings, Wikipedia.
RESULTPNG image file

Tips: You can combine options with apiKey. ex: "..../tt1234567/FullCast,Wikipedia,k_1234567"

Examples

Test

Options
https://imdb-api.com/en/API/Report/k_12345678/tt1375666

Get all subtitles from Subscene as JSON. BETA: Currently only Farsi/Persian (fa) language is supported.

ParametersRequiredDescription
langOptionalLanguage of results. Default value is "fa" (Farsi/Persian). Currently only Farsi/Persian (fa) language is supported.
apiKeyRequiredAPI Key required for all API calls. Register on site to get free API Key.
idRequiredA valid IMDb Id. Id started with tt.
seasonNumberOptionalA integer number for get subtitles only on that season. It using for Series TVs.
RESULTSubtitleData

Examples

Test

https://imdb-api.com/en/API/Subtitles/k_12345678/tt1375666

Get full cast/crew and actors/actresses of Movie or Series TV.

ParametersRequiredDescription
langOptionalLanguage of results. Default value is "en" (English). Language change is not important in this action.
apiKeyRequiredAPI Key required for all API calls. Register on site to get free API Key.
idRequiredA valid IMDb Id. Id started withs tt.
RESULTFullCastData

Examples

Test

https://imdb-api.com/en/API/FullCast/k_12345678/tt1375666

Get Posters of Movie or Series TV.

ParametersRequiredDescription
langOptionalLanguage of results. Default value is "en" (English). Language change is not important in this action.
apiKeyRequiredAPI Key required for all API calls. Register on site to get free API Key.
idRequiredA valid IMDb Id. Id started withs tt.
RESULTPosterData

Examples

Test

https://imdb-api.com/en/API/Posters/k_12345678/tt1375666

Get images of Movie or Series TV or People (Name) (tt1234567) and Name (nm1234567).

ParametersRequiredDescription
langOptionalLanguage of results. Default value is "en" (English). Language change is not important in this action.
apiKeyRequiredAPI Key required for all API calls. Register on site to get free API Key.
idRequiredA valid IMDb Id. Id started withs tt or nm.
optionsOptionalOptions can Short (default) or Full. Short parameter contains 48 images. Full parameter (tt only) contains all available images.
RESULTImageData

Examples

Test

Options
https://imdb-api.com/en/API/Images/k_12345678/tt1375666/Short

Get trailers of Movie or Series TV.

ParametersRequiredDescription
langOptionalLanguage of results. Default value is "en" (English). Language change is not important in this action.
apiKeyRequiredAPI Key required for all API calls. Register on site to get free API Key.
idRequiredA valid IMDb Id. Id started withs tt.
RESULTTrailerData

Examples

Test

https://imdb-api.com/en/API/Trailer/k_12345678/tt1375666

Get ratings of Movie or Series TV in: IMDb, Metacritic, RottenTomatoes, TheMovieDb and TV.com.

ParametersRequiredDescription
langOptionalLanguage of results. Default value is "en" (English). Language change is not important in this action.
apiKeyRequiredAPI Key required for all API calls. Register on site to get free API Key.
idRequiredA valid IMDb Id. Id started withs tt.
RESULTRatingData

Examples

Test

https://imdb-api.com/en/API/Ratings/k_12345678/tt1375666

Get user ratings of Movie or Series TV with count of votes and details.

ParametersRequiredDescription
langOptionalLanguage of results. Default value is "en" (English). Language change is not important in this action.
apiKeyRequiredAPI Key required for all API calls. Register on site to get free API Key.
idRequiredA valid IMDb Id. Id started withs tt.
RESULTUserRatingData

Examples

Test

https://imdb-api.com/en/API/UserRatings/k_12345678/tt1375666

Get episodes of season in Series TV.

ParametersRequiredDescription
langOptionalLanguage of results. Default value is "en" (English). Language change is not important in this action.
apiKeyRequiredAPI Key required for all API calls. Register on site to get free API Key.
idRequiredA valid IMDb Id. Id started withs tt.
seasonNumberRequiredSeason number to get episodes.
RESULTSeasonEpisodeData

Examples

Test

https://imdb-api.com/en/API/SeasonEpisodes/k_12345678/tt0411008/1

Get Movie or Series TV in all external sites with Identifier and URL.

ParametersRequiredDescription
langOptionalLanguage of results. Default value is "en" (English). Language change is not important in this action.
apiKeyRequiredAPI Key required for all API calls. Register on site to get free API Key.
idRequiredA valid IMDb Id. Id started withs tt.
RESULTExternalSiteData

Examples

Test

https://imdb-api.com/en/API/ExternalSites/k_12345678/tt1375666

Get Wikipedia plot of Movie or Series TV (tt1234567) as PlainText and Html.

ParametersRequiredDescription
langOptionalLanguage of results. Default value is "en" (English). Language is important for return value of wikipedia plot.
apiKeyRequiredAPI Key required for all API calls. Register on site to get free API Key.
idRequiredA valid IMDb Id. Id started withs tt.
RESULTWikipediaData

Examples

Test

https://imdb-api.com/en/API/Wikipedia/k_12345678/tt1375666

Get data from IMDb List.

ParametersRequiredDescription
langOptionalLanguage of results. Default value is "en" (English). Language change is not important in this action.
apiKeyRequiredAPI Key required for all API calls. Register on site to get free API Key.
idRequiredA valid IMDb List Id. Id started withs ls.
RESULTIMDbListData

Examples

Test

https://imdb-api.com/en/API/IMDbList/k_12345678/ls004285275

Others

Get Top 250 Movies.

ParametersRequiredDescription
langOptionalLanguage of results. Default value is "en" (English). Language change is not important in this action.
apiKeyRequiredAPI Key required for all API calls. Register on site to get free API Key.
RESULTTop250Data

Test

https://imdb-api.com/en/API/Top250Movies/k_12345678

Get Top 250 Series TVs.

ParametersRequiredDescription
langOptionalLanguage of results. Default value is "en" (English). Language change is not important in this action.
apiKeyRequiredAPI Key required for all API calls. Register on site to get free API Key.
RESULTTop250Data

Test

https://imdb-api.com/en/API/Top250TVs/k_12345678

Get Top 100 Most Polular Movies.

ParametersRequiredDescription
langOptionalLanguage of results. Default value is "en" (English). Language change is not important in this action.
apiKeyRequiredAPI Key required for all API calls. Register on site to get free API Key.
RESULTMostPopularData

Test

https://imdb-api.com/en/API/MostPopularMovies/k_12345678

Get Top 100 Most Polular Series TVs.

ParametersRequiredDescription
langOptionalLanguage of results. Default value is "en" (English). Language change is not important in this action.
apiKeyRequiredAPI Key required for all API calls. Register on site to get free API Key.
RESULTMostPopularData

Test

https://imdb-api.com/en/API/MostPopularTVs/k_12345678

Get In Theaters Movies.

ParametersRequiredDescription
langOptionalLanguage of results. Default value is "en" (English). Language change is not important in this action.
apiKeyRequiredAPI Key required for all API calls. Register on site to get free API Key.
RESULTNewMovieData

Test

https://imdb-api.com/en/API/InTheaters/k_12345678

Get Coming Soon Movies.

ParametersRequiredDescription
langOptionalLanguage of results. Default value is "en" (English). Language change is not important in this action.
apiKeyRequiredAPI Key required for all API calls. Register on site to get free API Key.
RESULTNewMovieData

Test

https://imdb-api.com/en/API/ComingSoon/k_12345678

Get Weekend Box Office.

ParametersRequiredDescription
langOptionalLanguage of results. Default value is "en" (English). Language change is not important in this action.
apiKeyRequiredAPI Key required for all API calls. Register on site to get free API Key.
RESULTBoxOfficeWeekendData

Test

https://imdb-api.com/en/API/BoxOffice/k_12345678

Get Box Office in all times.

ParametersRequiredDescription
langOptionalLanguage of results. Default value is "en" (English). Language change is not important in this action.
apiKeyRequiredAPI Key required for all API calls. Register on site to get free API Key.
RESULTBoxOfficeAllTimeData

Test

https://imdb-api.com/en/API/BoxOfficeAllTime/k_12345678

Get information of people (actor, actress, director, writers, ...).

ParametersRequiredDescription
langOptionalLanguage of results. Default value is "en" (English). Language change is not important in this action.
apiKeyRequiredAPI Key required for all API calls. Register on site to get free API Key.
idRequiredA valid IMDb Name Id. Id startd withs nm.
RESULTNameData

Examples

Test

https://imdb-api.com/en/API/Name/k_12345678/nm0000154

Get information of company with movies.

ParametersRequiredDescription
langOptionalLanguage of results. Default value is "en" (English). Language change is not important in this action.
apiKeyRequiredAPI Key required for all API calls. Register on site to get free API Key.
idRequiredA valid IMDb Company Id. Id started withs co.
RESULTCompanyData

Examples

Test

https://imdb-api.com/en/API/Company/k_12345678/co0002663

Get Movie or Series TVs in this keyword.

ParametersRequiredDescription
langOptionalLanguage of results. Default value is "en" (English). Language change is not important in this action.
apiKeyRequiredAPI Key required for all API calls. Register on site to get free API Key.
idRequiredA valid IMDb Keyword (already founded in SearchKeyword action)
RESULTKeywordData

Examples

Test

https://imdb-api.com/en/API/Keyword/k_12345678/dramas

Get YouTube Trailer URL by IMDb Id.

ParametersRequiredDescription
langOptionalLanguage of results. Default value is "en" (English). Language change is not important in this action.
apiKeyRequiredAPI Key required for all API calls. Register on site to get free API Key.
idRequiredA valid IMDb Id. Id started withs tt.
RESULTYouTubeTrailerData

Examples

Test

https://imdb-api.com/en/API/YouTubeTrailer/k_12345678/tt1375666

YouTube Downloader by Video Id or URL.

ParametersRequiredDescription
langOptionalLanguage of results. Default value is "en" (English). Language change is not important in this action.
apiKeyRequiredAPI Key required for all API calls. Register on site to get free API Key.
vRequiredA valid YouTube Video Id or YouTube URL
RESULTYouTubeData

Examples

Test

https://imdb-api.com/en/API/YouTube/k_12345678/8hP9D6kZseM

YouTube Downloader by Playlist Id or URL.

ParametersRequiredDescription
langOptionalLanguage of results. Default value is "en" (English). Language change is not important in this action.
apiKeyRequiredAPI Key required for all API calls. Register on site to get free API Key.
listRequiredA valid YouTube Playlist Id or YouTube Playlist URL
RESULTYouTubePlaylistData

Examples

Test

https://imdb-api.com/en/API/YouTubePlaylist/k_12345678/PLReL099Y5nRd28Yv6c-Am9qURCrLMxBmK

Download

Get Posters by sizes.

ParametersRequiredDescription
sizeRequiredSize of Poster. default value is original.
Supported Sizes
Wide - Ratio 6:9/9:6 : original, w45, w92, w154, w185, w200, w300, w342, w400, w500, w780 and w1280
Square - Ratio 1:1 : s32, s45, s50, s64, s66, s90, s100, s115, s128, s132, s150, s180, s230, s235, s264, s300, s375, s470
RESULTJPG image file

Examples

Test

https://imdb-api.com/Posters/original/n9dwu1p5G4qJ4DI5eHJMUbAdOfA.jpg

Code Snippet

Click on Language Programming to active
// IMDbApiLib Package on Nuget : https://nuget.org/packages/IMDbApiLib
var apiLib = new ApiLib("API-Key");
var data = await apiLib.TitleAsync("tt0110413");
var client = new RestClient("https://imdb-api.com/en/API/Title/k_1234567/tt1832382");
client.Timeout = -1;
var request = new RestRequest(Method.GET);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
CURL *curl;
CURLcode res;
curl = curl_easy_init();
if(curl) {
  curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "GET");
  curl_easy_setopt(curl, CURLOPT_URL, "https://imdb-api.com/en/API/Title/k_1234567/tt1832382");
  curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
  curl_easy_setopt(curl, CURLOPT_DEFAULT_PROTOCOL, "https");
  struct curl_slist *headers = NULL;
  curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
  res = curl_easy_perform(curl);
}
curl_easy_cleanup(curl);
package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://imdb-api.com/en/API/Title/k_1234567/tt1832382"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
  }
  res, err := client.Do(req)
  defer res.Body.Close()
  body, err := ioutil.ReadAll(res.Body)

  fmt.Println(string(body))
}
OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
Request request = new Request.Builder()
  .url("https://imdb-api.com/en/API/Title/k_1234567/tt1832382")
  .method("GET", null)
  .build();
Response response = client.newCall(request).execute();
Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.get("https://imdb-api.com/en/API/Title/k_1234567/tt1832382")
  .asString();
var requestOptions = {
  method: 'GET',
  redirect: 'follow'
};

fetch('https://imdb-api.com/en/API/Title/k_1234567/tt1832382', requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));
var settings = {
  "url": "https://imdb-api.com/en/API/Title/k_1234567/tt1832382",
  "method": "GET",
  "timeout": 0,
};

$.ajax(settings).done(function (response) {
  console.log(response);
});
var xhr = new XMLHttpRequest();

xhr.addEventListener("readystatechange", function() {
  if(this.readyState === 4) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://imdb-api.com/en/API/Title/k_1234567/tt1832382");

xhr.send();
var https = require('follow-redirects').https;
var fs = require('fs');

var options = {
  'method': 'GET',
  'hostname': 'imdb-api.com',
  'port': 443,
  'path': '/en/API/Title/k_1234567/tt1832382',
  'headers': {
  },
  'maxRedirects': 20
};

var req = https.request(options, function (res) {
  var chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function (chunk) {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
  });

  res.on("error", function (error) {
    console.error(error);
  });
});

req.end();
var request = require('request');
var options = {
  'method': 'GET',
  'url': 'https://imdb-api.com/en/API/Title/k_1234567/tt1832382',
  'headers': {
  }
};
request(options, function (error, response) { 
  if (error) throw new Error(error);
  console.log(response.body);
});
var unirest = require('unirest');
var req = unirest('GET', 'https://imdb-api.com/en/API/Title/k_1234567/tt1832382')
  .end(function (res) { 
    if (res.error) throw new Error(res.error); 
    console.log(res.raw_body);
  });
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://imdb-api.com/en/API/Title/k_1234567/tt1832382",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://imdb-api.com/en/API/Title/k_1234567/tt1832382');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
  'follow_redirects' => TRUE
));
try {
  $response = $request->send();
  if ($response->getStatus() == 200) {
     echo $response->getBody();
  } else {
    echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
      $response->getReasonPhrase();
  }
} catch(HTTP_Request2_Exception $e) {
  echo 'Error: ' . $e->getMessage();
}
<?php
$client = new http\Client;
$request = new http\Client\Request;
$request->setRequestUrl('https://imdb-api.com/en/API/Title/k_1234567/tt1832382');
$request->setRequestMethod('GET');
$request->setOptions(array());

$client->enqueue($request)->send();
$response = $client->getResponse();
echo $response->getBody();
$response = Invoke-RestMethod 'https://imdb-api.com/en/API/Title/k_1234567/tt1832382' -Method 'GET' -Headers $headers -Body $body
$response | ConvertTo-Json
import http.client
import mimetypes
conn = http.client.HTTPSConnection("imdb-api.com", 443)
payload = ''
headers = {}
conn.request("GET", "/en/API/Title/k_1234567/tt1832382", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
import requests

url = "https://imdb-api.com/en/API/Title/k_1234567/tt1832382"

payload = {}
headers= {}

response = requests.request("GET", url, headers=headers, data = payload)

print(response.text.encode('utf8'))
require "uri"
require "net/http"

url = URI("https://imdb-api.com/en/API/Title/k_1234567/tt1832382")

https = Net::HTTP.new(url.host, url.port);
https.use_ssl = true

request = Net::HTTP::Get.new(url)

response = https.request(request)
puts response.read_body
import Foundation

var semaphore = DispatchSemaphore (value: 0)

var request = URLRequest(url: URL(string: "https://imdb-api.com/en/API/Title/k_1234567/tt1832382")!,timeoutInterval: Double.infinity)
request.httpMethod = "GET"

let task = URLSession.shared.dataTask(with: request) { data, response, error in 
  guard let data = data else {
    print(String(describing: error))
    return
  }
  print(String(data: data, encoding: .utf8)!)
  semaphore.signal()
}

task.resume()
semaphore.wait()