Atlas / Categories / Video / TMDb Video — entry 030 of 37
TMDb Verified Jul 2026
TMDb is a community-maintained catalog of movies, TV shows, and people (cast/crew, posters, ratings, translations) built from volunteer contributions rather than a single studio or rights-holder feed. It's free for personal and most developer use via an API key, with commercial or large-scale use requiring a separate agreement with TMDb.
movie-data tv-data community-data metadata
Authentication API Key Sign up with the provider to obtain credentials.
HTTPS Supported Traffic is encrypted in transit.
CORS Enabled Callable directly from browser JavaScript.
Pricing Freemium A usable free tier exists, with paid plans for more volume.
Formats JSON Responses can be requested as JSON.
GreatAPIs Score Score 81 out of 100
Authentication 15/25 API key required
Pricing 17/20 Freemium tier available
Docs 20/20 Machine-readable spec file bundled
Formats 9/15 Single response format
Freshness 20/20 Verified within 6 months
Embed this badge <a href="https://greatapis.com/api/tmdb/"><img src="https://greatapis.com/badge/tmdb.svg" alt="Scored 81 on greatapis.com"></a>
Auth quickstart Sign up with the provider to get an API key. Send it on every request as a header Authorization: <key>The exact header isn't documented — Authorization is a common default; confirm in the provider's docs. Stored key No key stored Clear key
Your key is stored only in this browser (localStorage) and sent directly to the API — never to greatapis.
Endpoints 3 12 GET /3/configurationDetails Responses Status Description Schema 200200 —
GET /3/discover/movieMovie Parameters Name In Required Type certificationquery no string certification.gtequery no string certification.ltequery no string certification_countryquery no string include_adultquery no boolean include_videoquery no boolean languagequery no string pagequery no integer primary_release_yearquery no integer primary_release_date.gtequery no string primary_release_date.ltequery no string regionquery no string release_date.gtequery no string release_date.ltequery no string sort_byquery no string vote_average.gtequery no number vote_average.ltequery no number vote_count.gtequery no number vote_count.ltequery no number watch_regionquery no string with_castquery no string with_companiesquery no string with_crewquery no string with_genresquery no string with_keywordsquery no string with_origin_countryquery no string with_original_languagequery no string with_peoplequery no string with_release_typequery no integer with_runtime.gtequery no integer with_runtime.ltequery no integer with_watch_monetization_typesquery no string with_watch_providersquery no string without_companiesquery no string without_genresquery no string without_keywordsquery no string without_watch_providersquery no string yearquery no integer
Responses Status Description Schema 200200 —
GET /3/genre/movie/listMovie List Parameters Name In Required Type languagequery no string
Responses Status Description Schema 200200 —
GET /3/movie/popularPopular Parameters Name In Required Type languagequery no string pagequery no integer regionquery no string
Responses Status Description Schema 200200 —
GET /3/movie/top_ratedTop Rated Parameters Name In Required Type languagequery no string pagequery no integer regionquery no string
Responses Status Description Schema 200200 —
GET /3/movie/{movie_id}Details Parameters Name In Required Type movie_idpath yes integer append_to_responsequery no string languagequery no string
Responses Status Description Schema 200200 —
GET /3/person/{person_id}Details Parameters Name In Required Type person_idpath yes integer append_to_responsequery no string languagequery no string
Responses Status Description Schema 200200 —
GET /3/search/movieMovie Parameters Name In Required Type queryquery yes string include_adultquery no boolean languagequery no string primary_release_yearquery no string pagequery no integer regionquery no string yearquery no string
Responses Status Description Schema 200200 —
GET /3/search/multiMulti Parameters Name In Required Type queryquery yes string include_adultquery no boolean languagequery no string pagequery no integer
Responses Status Description Schema 200200 —
GET /3/trending/all/{time_window}All Parameters Name In Required Type time_windowpath yes string languagequery no string
Responses Status Description Schema 200200 —
GET /3/tv/popularPopular Parameters Name In Required Type languagequery no string pagequery no integer
Responses Status Description Schema 200200 —
GET /3/tv/{series_id}Details Parameters Name In Required Type series_idpath yes integer append_to_responsequery no string languagequery no string
Responses Status Description Schema 200200 —
Developer reference Base URL https://api.themoviedb.org/3
Rate limit No fixed limit currently enforced; TMDB asks clients to back off on HTTP 429 (the legacy 40 req/10s cap was removed in 2019)
Key endpoints GET /3/search/movie GET /3/movie/{movie_id} GET /3/movie/popular GET /3/trending/all/{time_window} GET /3/discover/movie 