682

I recently found a movie organizer application which fetches its data from the IMDB database.

Does IMDB provide an API for this, or any third party APIs available?

4
  • 10
    Is there any API for reviews on IMDB ?
    – metdos
    Commented Apr 6, 2011 at 7:20
  • 1
    To just link IMDB use following format.<a href="http://www.imdb.com/title/{{{ $imdb_id }}}">{{{ $imdb_id }}}</a> BTW: imdb_id follows this pattern: tt0000000
    – Igor Parra
    Commented Mar 29, 2014 at 17:11
  • 1
    whats the name of this movie organizer application? I am looking for something like that
    – Airlike
    Commented Jul 8, 2014 at 18:38
  • @Airlike Possibly Plex. I know for sure that one organizes movies and can retrieve data from IMDB.
    – mason
    Commented Nov 7, 2014 at 19:07

18 Answers 18

478
+500

The IMDb has a public API that, although undocumented, is fast and reliable (used on the official website through AJAX).

Search Suggestions API

// 1) Vanilla JavaScript (JSON-P)
function addScript(src) { var s = document.createElement('script'); s.src = src; document.head.appendChild(s); }
window.imdb$foo = function (results) {
  /* ... */
};
addScript('https://sg.media-imdb.com/suggests/f/foo.json');

// 2) Using jQuery (JSON-P)
jQuery.ajax({
    url: 'https://sg.media-imdb.com/suggests/f/foo.json',
    dataType: 'jsonp',
    cache: true,
    jsonp: false,
    jsonpCallback: 'imdb$foo'
}).then(function (results) {
    /* ... */
});

// 3) Pure JSON (with jQuery)
// Use a local proxy to the clean `/suggestion` API.
jQuery.getJSON('/api/imdb/?q=foo', function (results) {
    /* ... */
});

// 4) Pure JSON (plain JavaScript; Modern ES6, ES2017, and Fetch API)
// Serve a "/api" route in your app, that proxies (and caches!)
// to v2.sg.media-imdb.com/suggestion/h/hello.json
const resp = await fetch('/api/imdb/?q=foo');
const results = await resp.json();

Advanced Search


Beware that these APIs are unofficial and could change at any time!


Update (January 2019): The Advanced API no longer exists. The good news is, that the Suggestions API now supports the "advanced" features of searching by film titles and actor names as well.

11
  • 2
    RE: The JSONP API not gracefully falling back, (at least) it does return an HTTP error code, but I agree that it's funny that the response body is XML. Commented Dec 22, 2011 at 5:00
  • 10
    I recently noticed that it also includes an 'i' property for images. The url mentioned therein however is a very large image (likely the original). To get a thumbnail, IMDb uses the following: if (ua.i) { c.img = { src: ua.i[0].replace("._V1_.jpg", "._V1._SX40_CR0,0,40,54_.jpg"), width: 40, height: 54 } }. Commented Sep 29, 2012 at 0:01
  • 2
    could you not just specify jsonp with.Ajax if you getting json with jquery and i think getjson has been deprecated even when this was written it was deprecated i do believe Commented Dec 8, 2012 at 6:56
  • 2
    @ChrisMcGrath: I hadn't thought about using jQuery.ajax jsonpCallback, I've added it to the answer, Thanks! As for $.getJSON: No, that has most certainly not been deprecated. It is just a small wrapper around $.ajax. Commented Dec 9, 2012 at 18:42
  • 2
    Does anyone know how to get included images in the advanced search? Seems they only come with the suggestions... Commented Feb 17, 2013 at 19:58
225

new api @ http://www.omdbapi.com

edit: due to legal issues had to move the service to a new domain :)

17
  • 1
    That's awesome, not sure if this is actually yours or you just found it but would love to see something around uptime stats so I could know how much I can count on it :D Commented Apr 13, 2011 at 3:19
  • 17
    In case anyone is wondering, this is not the official API. See Pekka or Krinkle answers for that.
    – Jano
    Commented Dec 28, 2011 at 8:53
  • 7
    its really slow..;( Commented Feb 17, 2012 at 23:09
  • 16
    @IanDavis, I'm currently working on getting a new faster/bigger dedicated server for the API, Which isn't cheap! I've almost got enough donations to acquire this within the next few days. The API is getting over 2 million requests a day!
    – bfritz
    Commented May 4, 2012 at 23:59
  • 4
    @OptimusCrime I had an issue the other day with IP's from the 85.XXX.XXX.XXX range and had to temporarily block ALL of them until I could get things under control. Sadly this is one of the trade-offs I have to deal with by not requiring API keys, people tend to just abuse the hell out of it.
    – bfritz
    Commented Jul 1, 2014 at 16:14
100

IMDB themselves seem to distribute data, but only in text files:

http://www.imdb.com/interfaces

there are several APIs around this that you can Google. Screen scraping is explicitly forbidden. A official API seems to be in the works, but has been that for years already.

12
  • 8
    How is it possible for screen scraping to be forbidden?
    – user9903
    Commented Jan 1, 2011 at 21:11
  • 15
    @omouse From the terms: Robots and Screen Scraping: You may not use data mining, robots, screen scraping, or similar data gathering and extraction tools on this site, except with our express written consent as noted below. that doesn't make these terms automatically enforceable in every jurisdiction, but they are in many.
    – Pekka
    Commented Jan 1, 2011 at 21:19
  • 7
    Yes but this dialog was directed at "Robots". Apparently my robot doesn't understand English so oh well.
    – Zombies
    Commented May 12, 2013 at 10:58
  • 2
    As of December 2017, these files are no longer being updated by IMDb. There is a new API that supplies data in a new format. While easier to parse, this new format is a very small subset of the previous format. Commented Dec 22, 2017 at 4:22
  • 3
    I realize this is an extremely old question and answer. However, data mining publicly accessible data is not legally enforceable if you didn't sign a EULA. Even if you did, if the information is publicly accessible through other means, the EULA is still not legally binding. A major decision was recently made to this very effect against LinkedIn. See: eff.org/deeplinks/2019/09/… IANAL but the EFF are. It's a very sensible ruling. If you put information on the Internet, you should expect people to do stuff with it. Commented Feb 29, 2020 at 22:47
51

Another legal alternative to get movie info is the Rotten-Tomatoes API (by Fandango).

9
  • Is the rotten tomatoes API free to use in a commercial application? Say, for example, to have users get the details of a movie from its title?
    – KerrM
    Commented Jul 26, 2012 at 21:27
  • 1
    It doesn't look like they're making any distinction between commercial or non-commercial app. You can always have a look at their TOS here: developer.rottentomatoes.com/apps/tos Although you will be limited to 10,000 calls per day and 10 per seconds
    – Johann
    Commented Jul 27, 2012 at 9:23
  • 1
    If you are providing a non-commercial program and need more than 10,000 calls per day, you can talk to them about licencing. The terms are fairly simple and easy to comply with, in that you have to display their logo and/or a particular phrase of wording for the rating.
    – Omertron
    Commented Aug 21, 2012 at 8:56
  • 7
    WTF? "The API is intended for use in the U.S. only. Deploying content outside of this territory must be approved by the Rotten Tomatoes team. The API may NOT be shared with any third parties." Commented Feb 18, 2015 at 1:23
  • 1
    @DanDascalescu What a pity. I was going to use it outside de US Commented Apr 5, 2020 at 12:43
50

What about TMDb API ?

You can search by imdb_id with GET /find/{external_id}

https://developers.themoviedb.org/3/find/find-by-id

5
  • 10
    Requires a registration and a 3 business day approval process though
    – Kostas
    Commented Apr 3, 2011 at 11:30
  • tmdb api can use the dvd's unique id to lookup the imdb_id, if that helps. Assuming they have it listed, of course. dvdid.info might help, too.
    – rogerdpack
    Commented Jun 24, 2011 at 21:41
  • 8
    vrinek - wrong, it sent me API key immediately.
    – oriharel
    Commented Jan 14, 2014 at 20:24
  • 1
    It's no problem to get an API key for this. Have been using one for years, and its API is well designed.
    – john16384
    Commented May 14, 2019 at 9:27
  • @Kostas Not for development account. The dev account is instantly registered.
    – Adil Malik
    Commented May 18, 2021 at 18:50
31

Yes, but not for free.

.....annual fees ranging from $15,000 to higher depending on the audience for the data and which data are being licensed.

URL :- http://www.imdb.com/licensing/

4
  • 3
    appears it's free for "personal" use only otherwise you have to contact them...wow we really need an open equivalent of imdb, though I suppose tmdb is close...
    – rogerdpack
    Commented Jun 24, 2011 at 21:54
  • hi, this is not really an answer to the question, more a comment to above. Commented Jul 21, 2013 at 20:31
  • 8
    @IanVaughan, I believe my answer directly addresses this question: Q: "Does IMDB provide an API for this...?". A: "Yes...[link to data licensing info]." It's not my fault, IMDB doesn't publicly document an API reference. Commented Jul 22, 2013 at 21:00
  • 9
    Sorry, I think you are right, I stand corrected. Apologies. Commented Jul 23, 2013 at 13:02
22

There is a JSON API for use by mobile applications at http://app.imdb.com

However, the warning is fairly severe:

For use only by clients authorized in writing by IMDb.
Authors and users of unauthorized clients accept full legal exposure/liability for their actions.

I presume this is for those developers that pay for the licence to access the data via their API.

EDIT: Just for kicks, I wrote a client library to attempt to read the data from the API, you can find it here: api-imdb

Obviously, you should pay attention to the warning, and really, use something like TheMovieDB as a better and more open database.

Then you can use this Java API wrapper (that I wrote): api-themoviedb

3
9

Found this one

IMDbPY is a Python package useful to retrieve and manage the data of the IMDb movie database about movies, people, characters and companies.

http://imdbpy.sourceforge.net/

1
8

https://deanclatworthy.com/tools.html is an IMDB API but has been down due to abuse.

6
  • 1
    unfortunately, it will be closed down soon. Do you know how does it work?
    – PA.
    Commented Jan 26, 2010 at 15:11
  • 1
    It only offers a very limited search too, by movie title only
    – justinhj
    Commented Jan 17, 2011 at 0:15
  • Checkout malhar2010.blogspot.com/2011/02/… for using IMDb api.
    – user634057
    Commented Feb 25, 2011 at 11:54
  • 12
    As the author of this API, I should point out that the above comments are now redundant as it's not being closed down, and that you can now search by IMDB ID.
    – Dean
    Commented Mar 17, 2012 at 22:15
  • for free imdb API see this 99webtools.com/get-movie-info-imdb.php
    – Sunny
    Commented Nov 22, 2013 at 17:18
7

IMDB doesn't seem to have a direct API as of August 2016 yet but I saw many people writing scrapers and stuff above. Here is a more standard way to access movie data using box office buzz API. All responses in JSON format and 5000 queries per day on a free plan

List of things provided by the API

  1. Movie Credits
  2. Movie ID
  3. Movie Images
  4. Get movie by IMDB id
  5. Get latest movies list
  6. Get new releases
  7. Get movie release dates
  8. Get the list of translations available for a specific movie
  9. Get videos, trailers, and teasers for a movie
  10. Search for a movie by title
  11. Also supports TV shows, games and videos
0
3

that deanclatworthy still seems to work and there's another one: http://imdbapi.poromenos.org/

1
3

Here is a simple solution that fetches shows by name based on the query from Krinkle:

You can get around the same-origin policy by having your server fetch the URL instead of trying to fetch it directly with AJAX and you don't have to use JSONP to do it.

Javascript (jQuery):

function getShowOptionsFromName (name) {
    $.ajax({
        url: "ajax.php",
        method: "GET",
        data: {q: name},
        dataType: "json"
    }).done(function(data){
        console.log(data);
    });
}

PHP (in file ajax.php):

$q = urlencode($_GET["q"]);
echo file_get_contents("http://www.imdb.com/xml/find?json=1&nr=1&tt=on&q=$q");
3

If you want movie details API then you can consider

OMDB API which is Open movies Database. It returns IMDB Ratings, IMDB Votes and it also has Rotten Tomato rating.

Or else You can use

My Api Films which allows you to search with IMDB ID, it returns detailed information but it has request limits.

2

Recently at SXSWi 2012, in their "Mashery Lounge", there was a booth for an IMDB-like API called from rovi. It's not a free API, but according to the sales guy I talked to they offer either a rev share or a flat fee for usage, depending on your budget. I haven't used it yet but it seems pretty cool.

1
  • no longer alive.
    – BishopZ
    Commented Apr 23, 2019 at 15:45
2

NetFilx is more of personalized media service but you can use it for public information regarding movies. It supports Javascript and OData.
Also look JMDb: The information is basically the same as you can get when using the IMDb website.

1
  • 1
    Netflix shut down their public API almost a year ago. Since they took down the entire developer sub-domain, including the post saying they were shutting it down, here's a link to a news piece on it: gigaom.com/2014/11/14/… Commented Aug 23, 2015 at 23:31
1

ok i found this one IMDB scraper

for C#: http://web3o.blogspot.de/2010/11/aspnetc-imdb-scraping-api.html

PHP here: http://web3o.blogspot.de/2010/10/php-imdb-scraper-for-new-imdb-template.html

alternatively a imdbapi.org implementation for c#:

using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Net;
using System.Xml.Linq;
using HtmlAgilityPack; // http://htmlagilitypack.codeplex.com/


public class IMDBHelper
{

    public static imdbitem GetInfoByTitle(string Title)
    {
        string url = "http://imdbapi.org/?type=xml&limit=1&title=" + Title;
        HttpWebRequest req = (HttpWebRequest)HttpWebRequest.Create(url);
        req.Method = "GET";
        req.UserAgent = "Mozilla/5.0 (Windows; U; MSIE 9.0; WIndows NT 9.0; en-US))";
        string source;
        using (StreamReader reader = new StreamReader(req.GetResponse().GetResponseStream()))
        {
            source = reader.ReadToEnd();
        }
        HtmlDocument doc = new HtmlDocument();
        doc.LoadHtml(source);        
        XDocument xdoc = XDocument.Parse(doc.DocumentNode.InnerHtml, LoadOptions.None);
        imdbitem i = new imdbitem();
        i.rating = xdoc.Descendants("rating").Select(x => x.Value).FirstOrDefault();
        i.rating_count = xdoc.Descendants("rating_count").Select(x => x.Value).FirstOrDefault();
        i.year = xdoc.Descendants("year").Select(x => x.Value).FirstOrDefault();
        i.rated = xdoc.Descendants("rated").Select(x => x.Value).FirstOrDefault();
        i.title = xdoc.Descendants("title").Select(x => x.Value).FirstOrDefault();
        i.imdb_url = xdoc.Descendants("imdb_url").Select(x => x.Value).FirstOrDefault();
        i.plot_simple = xdoc.Descendants("plot_simple").Select(x => x.Value).FirstOrDefault();
        i.type = xdoc.Descendants("type").Select(x => x.Value).FirstOrDefault();
        i.poster = xdoc.Descendants("poster").Select(x => x.Value).FirstOrDefault();
        i.imdb_id = xdoc.Descendants("imdb_id").Select(x => x.Value).FirstOrDefault();
        i.also_known_as = xdoc.Descendants("also_known_as").Select(x => x.Value).FirstOrDefault();
        i.language = xdoc.Descendants("language").Select(x => x.Value).FirstOrDefault();
        i.country = xdoc.Descendants("country").Select(x => x.Value).FirstOrDefault();
        i.release_date = xdoc.Descendants("release_date").Select(x => x.Value).FirstOrDefault();
        i.filming_locations = xdoc.Descendants("filming_locations").Select(x => x.Value).FirstOrDefault();
        i.runtime = xdoc.Descendants("runtime").Select(x => x.Value).FirstOrDefault();
        i.directors = xdoc.Descendants("directors").Descendants("item").Select(x => x.Value).ToList();
        i.writers = xdoc.Descendants("writers").Descendants("item").Select(x => x.Value).ToList();
        i.actors = xdoc.Descendants("actors").Descendants("item").Select(x => x.Value).ToList();
        i.genres = xdoc.Descendants("genres").Descendants("item").Select(x => x.Value).ToList();
        return i;
    }

    public class imdbitem
    {
        public string rating { get; set; }
        public string rating_count { get; set; }
        public string year { get; set; }
        public string rated { get; set; }
        public string title { get; set; }
        public string imdb_url { get; set; }
        public string plot_simple { get; set; }
        public string type { get; set; }
        public string poster { get; set; }
        public string imdb_id { get; set; }
        public string also_known_as { get; set; }
        public string language { get; set; }
        public string country { get; set; }
        public string release_date { get; set; }
        public string filming_locations { get; set; }
        public string runtime { get; set; }
        public List<string> directors { get; set; }
        public List<string> writers { get; set; }
        public List<string> actors { get; set; }
        public List<string> genres { get; set; }
    }

}
1
0

Here is a Python module providing API's to get data from IMDB website

http://techdiary-viki.blogspot.com/2011/03/imdb-api.html

3
  • That module uses screen-scraping, which is against the TOS
    – Farinha
    Commented Apr 18, 2011 at 12:40
  • 6
    Using IMDB at all in an app is against their TOS, apparently...
    – rogerdpack
    Commented Jun 24, 2011 at 21:51
  • ya, you have to contact them and request to use their content in your commercial application. It says in their TOS you have to have written consent from IMDB.
    – Mike
    Commented May 4, 2012 at 4:21
0

Im pretty confident that the application you found actually gets their information form Themoviedb.org's API(they get most of there stuff from IMDB). They have a free open API that is used alot of the movie organizer/XMBC applications.

Not the answer you're looking for? Browse other questions tagged or ask your own question.