Our API is available to use for free. A TMDb user account is required to request an API key.
As always, you must attribute TMDb as the source of your data. Please be sure to read the API FAQ.
New! As of October 25, 2013 our TV API has gone live! For more information about the TV api specifically, visit our TV API forum post. We're still adding methods so check back for the next week or two for updates.
There is a lot you can do with our API. Here is a quick recap of the basic features. For detailed information head over to the full documentation.
There is 3 ways to search for and find movies, TV shows and people on TMDb. They're outlined below.
/search - Text based search is the most common way. You provide a query string and we provide the closest match. Searching by text takes into account all original, translated, alternative names and titles.
/discover - Sometimes it useful to search for movies and TV shows based on definable values like ratings, certifications or release dates. The discover method make this easy. There's many values you can use to search for entries.
/find - The last but still very useful way to find data is with existing external IDs. For example, if you know the IMDB ID of a movie, TV show or person, you can plug that value into this method and we'll return anything that matches. This can be very useful when you have an existing tool and are adding our service to the mix.
Search: Search for movies with a text query.
Discover: Search for movies based on data. Movies are queryable by fields like average rating, certifications, release dates and genres.
Find: Find movies based on an external ID like an IMDB ID.
Search: Search for TV shows with a text query.
Discover: Search for TV shows based on data. TV shows are queryable by fields like average rating, air date, TV network and genres.
Find: Find TV shows based on an external ID like an IMDB ID.
Search: Search for people with a text query.
Find: Find people based on an external ID like an IMDB ID.