Welcome to version 4 of The Movie Database (TMDB) API. For help or support, visit our API support forum.To register for an API key, click the API link in your account settings.
The API registration process is not optimized for mobile devices. Please use a desktop computer and browser.
Before receiving an API key, you must agree to our terms of use. Read them here.
Learn about how users are being identify when interacting with our API
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"TMDB API Documentation","colors":{"primary":"#5ebedb","light":"#abf7f1","dark":"#5ebedb"},"logo":{"light":"https://mintcdn.com/ileolami/syMk3_IRf-DX-Dwg/logo/blue_short-8e7b30f73a4020692ccca9c88bafe5dcb6f8a62a4c6bc55cd9ba82bb2cd95f6c.svg?fit=max\u0026auto=format\u0026n=syMk3_IRf-DX-Dwg\u0026q=85\u0026s=4a4d8895f5c8445e6b13f91f5ba56bea","dark":"https://mintcdn.com/ileolami/syMk3_IRf-DX-Dwg/logo/blue_short-8e7b30f73a4020692ccca9c88bafe5dcb6f8a62a4c6bc55cd9ba82bb2cd95f6c.svg?fit=max\u0026auto=format\u0026n=syMk3_IRf-DX-Dwg\u0026q=85\u0026s=4a4d8895f5c8445e6b13f91f5ba56bea"},"favicon":"/6dc6435-small-favicon.png","navbar":{"links":[{"label":"Support","href":"https://www.themoviedb.org/about/get-in-touch/"},{"label":"Github","href":"https://github.com/Ileolami/docs"},{"label":"Service Status","href":"https://status.themoviedb.org/"}],"primary":{"type":"button","label":"Login","href":"https://www.themoviedb.org/login"}},"seo":{"metatags":{"title":"TMDB API Documentation","description":"This documentation is an assessment task under the mentorship program of TWMP","author":"Ileolami","image":"/images/blue_square_2-d537fb228cf3ded904ef09b136fe3fec72548ebc1fea3fbbd1ad9e36364db38b.svg","keywords":"TMDB API Documentation"},"indexing":"navigable"},"fonts":{"heading":{"family":"Playfair Display","weight":700,"source":"https://fonts.googleapis.com/css2?family=Playfair+Display:wght@700\u0026display=swap","format":"woff2"},"body":{"family":"Open Sans","weight":400,"source":"https://fonts.googleapis.com/css2?family=Open+Sans\u0026display=swap","format":"woff2"}},"integrations":{},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ileolami","hasAudioNarration":false,"actualSubdomain":"ileolami","customDomains":[],"gitSource":{"type":"github","owner":"ileolami","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a21e67b328cd78292a4f18a","collectionId":"1d5ca029-a031-41bb-8bec-16557765bbab","schemaVersion":"v2"},"entitlements":{},"buildId":"6ae9241f3e9b7a540d521f1c:success","clientVersion":"0.0.4076","searchFilterCounts":[{"language":"default","tag":"API Reference","count":175},{"language":"default","tag":"Getting Started","count":24},{"language":"default","tag":"TV SERIES","count":22},{"language":"default","tag":"ACCOUNT","count":21},{"language":"default","tag":"MOVIES","count":19},{"language":"default","tag":"LISTS","count":16},{"language":"default","tag":"Parameters","count":11},{"language":"default","tag":"PEOPLE","count":10},{"language":"default","tag":"TV EPISODES","count":10},{"language":"default","tag":"TV SEASONS","count":10}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".api-key{background-color:#01b4e4;width:400px;height:40px;border-radius:15px;margin:0 0 0 10px}"}],"page":{"pagePath":"version-4/documentation/getting","slug":"/version-4/documentation/getting","pageMetadata":{"title":"Introduction","icon":"house","description":null,"href":"/version-4/documentation/getting"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,p:`p`,..._provideComponents(),...props.components},{Card,CardGroup,Heading,Warning}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Welcome to version 4 of The Movie Database (TMDB) API. For help or support, visit our `,_jsx(_components.a,{href:`https://www.themoviedb.org/talk/category/5047958519c29526b50017d6`,children:`API support forum`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`To register for an API key, click the `,_jsx(_components.a,{href:`https://www.themoviedb.org/settings/api`,children:`API link`}),` in your account settings.`]}),`\n`,_jsx(Warning,{children:`The API registration process is not optimized for mobile devices. Please use a desktop computer and browser.`}),`\n`,_jsxs(_components.p,{children:[`Before receiving an API key, you must agree to our terms of use. Read them `,_jsx(_components.a,{href:`https://www.themoviedb.org/documentation/api/terms-of-use`,children:`here`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`dive-in-`,children:`Dive In 🚀`}),`\n`,_jsxs(CardGroup,{cols:3,children:[_jsx(Card,{title:`Application`,href:`/version-4/authetication/application`,icon:`window`,children:_jsx(`p`,{children:`Understand application-level authentication.`})}),_jsx(Card,{title:`API Reference`,icon:`book`,href:`/version-4/api-reference-4`,children:_jsx(`p`,{children:`Explore the full API reference documentation.`})}),_jsx(Card,{title:`User`,icon:`user`,href:`/version-4/authetication/user`,children:_jsx(`p`,{children:`Learn about how users are being identify when interacting with our API`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Introduction","icon":"house","description":null,"href":"/version-4/documentation/getting"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Dive In 🚀","slug":"dive-in-","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/ileolami/e2068eb00f9cb7fe/check.js"],"subdomain":"ileolami","siteName":"TMDB API Documentation","title":"Introduction - TMDB API Documentation","navMaps":{"firstHrefInVersion":{"3.0-stable":{"href":"/the-basics/introduction","matchLevel":4},"4.0":{"href":"/version-4/documentation/getting","matchLevel":0}},"firstHrefInLanguage":{}},"lastModified":"2026-01-07T05:48:03.365Z","originalFileLocation":"version-4/documentation/getting.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"This documentation is an assessment task under the mentorship program of TWMP\">\u003cmeta data-mint-head name=\"keywords\" content=\"TMDB API Documentation\">\u003cmeta data-mint-head name=\"application-name\" content=\"TMDB API Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ileolami/EmBnbKqu1uXEdqc-/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/ileolami/EmBnbKqu1uXEdqc-/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ileolami/EmBnbKqu1uXEdqc-/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ileolami/EmBnbKqu1uXEdqc-/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ileolami/EmBnbKqu1uXEdqc-/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ileolami/EmBnbKqu1uXEdqc-/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ileolami/EmBnbKqu1uXEdqc-/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ileolami/EmBnbKqu1uXEdqc-/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ileolami/EmBnbKqu1uXEdqc-/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Introduction - TMDB API Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"This documentation is an assessment task under the mentorship program of TWMP\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"TMDB API Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://ileolami.mintlify.app/version-4/documentation/getting\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ileolami.mintlify.site/_mintlify/api/og/v2?division=Documentation\u0026amp;title=Introduction\u0026amp;theme=d853acc82bfb27b5b218caf6\u0026amp;signature=830eb24858e26d6a8a3d432c75a3ec460285e097cbb76a230468338201100e67\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Introduction - TMDB API Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"This documentation is an assessment task under the mentorship program of TWMP\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ileolami.mintlify.site/_mintlify/api/og/v2?division=Documentation\u0026amp;title=Introduction\u0026amp;theme=d853acc82bfb27b5b218caf6\u0026amp;signature=830eb24858e26d6a8a3d432c75a3ec460285e097cbb76a230468338201100e67\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/ileolami/EmBnbKqu1uXEdqc-/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"TMDB API Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5ebedb\">\u003cmeta data-mint-head name=\"author\" content=\"Ileolami\">\u003cmeta data-mint-head name=\"image\" content=\"/images/blue_square_2-d537fb228cf3ded904ef09b136fe3fec72548ebc1fea3fbbd1ad9e36364db38b.svg\">\u003clink data-mint-head rel=\"canonical\" href=\"https://ileolami.mintlify.app/version-4/documentation/getting\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/version-4/documentation/getting.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://ileolami.mintlify.app/#organization\",\"name\":\"TMDB API Documentation\",\"url\":\"https://ileolami.mintlify.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/ileolami/syMk3_IRf-DX-Dwg/logo/blue_short-8e7b30f73a4020692ccca9c88bafe5dcb6f8a62a4c6bc55cd9ba82bb2cd95f6c.svg?fit=max\u0026auto=format\u0026n=syMk3_IRf-DX-Dwg\u0026q=85\u0026s=4a4d8895f5c8445e6b13f91f5ba56bea\"}},{\"@type\":\"WebSite\",\"@id\":\"https://ileolami.mintlify.app#website\",\"name\":\"TMDB API Documentation\",\"url\":\"https://ileolami.mintlify.app\",\"publisher\":{\"@id\":\"https://ileolami.mintlify.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://ileolami.mintlify.app/version-4/documentation/getting#webpage\",\"url\":\"https://ileolami.mintlify.app/version-4/documentation/getting\",\"name\":\"Introduction\",\"dateModified\":\"2026-01-07T05:48:03.365Z\",\"isPartOf\":{\"@id\":\"https://ileolami.mintlify.app#website\"},\"breadcrumb\":{\"@id\":\"https://ileolami.mintlify.app/version-4/documentation/getting#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://ileolami.mintlify.app/version-4/documentation/getting#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"TMDB API Documentation\",\"item\":\"https://ileolami.mintlify.app\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Introduction\",\"item\":\"https://ileolami.mintlify.app/version-4/documentation/getting\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://ileolami.mintlify.app/version-4/documentation/getting#article\",\"headline\":\"Introduction\",\"name\":\"Introduction\",\"url\":\"https://ileolami.mintlify.app/version-4/documentation/getting\",\"mainEntityOfPage\":{\"@id\":\"https://ileolami.mintlify.app/version-4/documentation/getting#webpage\"},\"dateModified\":\"2026-01-07T05:48:03.365Z\",\"publisher\":{\"@id\":\"https://ileolami.mintlify.app/#organization\"},\"isPartOf\":{\"@id\":\"https://ileolami.mintlify.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"TMDB API Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"TMDB API Documentation","nav":{"global":null,"versions":[{"version":"3.0-stable","pages":[{"title":"3.0-stable","href":"/the-basics/introduction"}]},{"version":"4.0","tabs":[{"tab":"Getting Started","groups":[{"group":"Documentation","pages":[{"title":"Introduction","icon":"house","href":"/version-4/documentation/getting"},{"title":"Application","icon":"window","description":"Authenticate your application to access the API.","href":"/version-4/authetication/application"},{"title":"User","icon":"user","href":"/version-4/authetication/user"}]}]},{"tab":"API Reference","dropdowns":[{"dropdown":"ACCOUNT","icon":"file-user","pages":[{"openapi":"get /4/account/{account_object_id}/lists","title":"Lists","href":"/version-4/api-reference-4/account/lists"},{"openapi":"get /4/account/{account_object_id}/movie/favorites","title":"Favorite Movies","href":"/version-4/api-reference-4/account/favorite-movies"},{"openapi":"get /4/account/{account_object_id}/tv/favorites","title":"Favorite Tv Show","href":"/version-4/api-reference-4/account/favorite-tv-show"},{"openapi":"get /4/account/{account_object_id}/movie/rated","title":"Rated Movies","href":"/version-4/api-reference-4/account/rated-movies"},{"openapi":"get /4/account/{account_object_id}/tv/rated","title":"Rated TV shows","href":"/version-4/api-reference-4/account/rated-tv-shows"},{"openapi":"get /4/account/{account_object_id}/movie/recommendations","title":"Recommend Movies","href":"/version-4/api-reference-4/account/recommend-movies"},{"openapi":"get /4/account/{account_object_id}/tv/recommendations","title":"Recommend TV Shows","href":"/version-4/api-reference-4/account/recommend-tv-shows"},{"openapi":"get /4/account/{account_object_id}/movie/watchlist","title":"Watchlist Movies","href":"/version-4/api-reference-4/account/watchlist-movies"},{"openapi":"get /4/account/{account_object_id}/tv/watchlist","title":"Watchlist TV Shows","href":"/version-4/api-reference-4/account/watchlist-tv-shows"}]},{"dropdown":"AUTH","icon":"shield","pages":[{"openapi":"post /4/auth/request_token","title":"Create a Request Token","href":"/version-4/api-reference-4/auth/create-a-request-token"},{"openapi":"post /4/auth/access_token","title":"Create an Access Token","href":"/version-4/api-reference-4/auth/create-an-access-token"},{"openapi":"delete /4/auth/access_token","title":"Logout","href":"/version-4/api-reference-4/auth/logout"}]},{"dropdown":"LISTS","icon":"list","pages":[{"openapi":"post /4/list/{list_id}/items","title":"Add items","href":"/version-4/api-reference-4/lists/add-items"},{"openapi":"get /4/list/{list_id}/clear","title":"Clear","href":"/version-4/api-reference-4/lists/clear"},{"openapi":"post /4/list","title":"Create","href":"/version-4/api-reference-4/lists/create-1"},{"openapi":"delete /4/list/{list_id}","title":"Delete","href":"/version-4/api-reference-4/lists/delete"},{"openapi":"get /4/list/{list_id}","title":"Details","href":"/version-4/api-reference-4/lists/details"},{"openapi":"get /4/list/{list_id}/item_status","title":"Item status","href":"/version-4/api-reference-4/lists/item-status"},{"openapi":"delete /4/list/{list_id}/items","title":"Remove Item","href":"/version-4/api-reference-4/lists/remove-item"},{"openapi":"put /4/list/{list_id}","title":"Update","href":"/version-4/api-reference-4/lists/update"},{"openapi":"put /4/list/{list_id}/items","title":"Update Item","href":"/version-4/api-reference-4/lists/update-item"}]}]}]}]},"basePath":"","title":"Introduction - TMDB API Documentation","buildId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","deploymentId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","dynamics":[],"chunks":[]}