{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"25e8fe02-2185-49bf-acdc-e25e0f3a2f47","name":"TMBD","description":"Welcome to version 3 (v3) of [The Movie Database (TMDB) API](https://developer.themoviedb.org/reference/intro/getting-started). This documentation serves as a guide to kick-start your experience with the world's largest movie database.\n\nOperating under the REST architecture, this API has become familiar to developers over the years, owing to its resemblance to the well-known web request and response pattern and its utilization of JSON as the preferred syntax for delivering responses.\n\nHere, you'll find information on all your favorite movies, including ratings, release dates, and much more. However, before you begin, be sure to explore the introductory pages, which include the Authentication page, and the Errors & status code page.\n\n## Authentication\n\nBefore you can use the TMBD API, you need to generate an API Key - which is how you authenticate with the API.\n\nTo get an API key, you need to sign up at the official [TMBD homepage](https://www.themoviedb.org/). To do sign up, follow the steps below:\n\n1. Navigate to the [TMBD sign up](https://www.themoviedb.org/signup) page.\n    \n2. After submitting your requested details, verify your account to login.\n    \n3. Once you're logged in, you can now access your profile page containing information such as you're most watched genres, and other recent activities.\n    \n4. At the right corner of your profile page, navigate to your profile Avatar and, select the **Settings** option.\n    \n5. On the setting page, navigate to the API option at the left corner menu.\n    \n6. From the following options, chose the plan that suites you. The options include Developer and Professional. Both plans have their advantages listed below them.\n    \n7. Once you select a plan, you'd fill out the form which would collect information about the API usage. Information requested would include name of application, it's url, etc.\n    \n8. Once completed, you would be redirected to a new page where you'll see your generated API Key. Or check the notification icon for an instant message deliverind your API key with additional information on the next steps to take.\n    \n\nThis process might seem all too long, but it takes less then 2 mins to complete.\n\nYour API Key allows you to authenticate with the API as well as make changes using your information. With that in mind, make sure to keep it in a secret location.\n\nRequests made without an API key will fail as well as requests made with an incorrect key!\n\nYou will learn more about the errors associated with API keys and other endpoints in the next section.\n\n## Errors & status codes\n\nWithout knowing what an error means, you might get confused while trying to debug a problem.\n\nBelow is a list of HTTP status codes and their meaning and the method used to make the request as it relates to the TMBD API:\n\n| **HTTP status code** | Meaning | **Method** |\n| --- | --- | --- |\n| 200 | This signal a successful request | GET |\n| 201 | A successful item update | POST |\n| 401 | When a token doesn't have write permission | POST |\n| 404 | Unable to find a resource/item | GET |\n| 405 | When the method used isn't supported by the resource | GET/POST/DELETE |\n| 429 | When you've passed the request limit count of 40 | GET/POST/DELETE |\n\n> **NOTE:** The method above explains the generation of error codes. For instance, a successful GET request results in a 200 status code, while a successful POST request yields a 201 code. \n  \n\nThere are also another table that will help you understand various errors in TMDB. This table includes the error types and their codes.\n\n| **Error code** | **Error type** | **Meaning** |\n| --- | --- | --- |\n| 401 | API key errors | API key related errors such as failed authentication, invalid API key, and, suspended API key. |\n| 422 | Parameter errors | Error types relating to parameters such as invalid/incorrect parameters, invalid date range and unapproved request token. |\n| 503 | Unavailability errors | These errors are related to the API being under maintenance or the a particular service being offline. |\n\n> **NOTE:** All errors are returned in JSON format. \n  \n\n## Rate limit\n\nEvery API enforces a set of rules that govern the usage of its database, and these rules are maintained through a rate limit. The rate limit represents the maximum number of requests allowed to be made to an API within a specific time interval, which can be per second, hour, or minute, depending on the API.\n\nThe presence of a rate limit is crucial as it enables API developers to monitor and control excessive data usage. It also plays a role in ensuring that the API developers can monetize their services. For the TMBD API, the rate limit is set at 50 requests per second initially, with an allowance of 40 requests per 10 seconds.\n\nKeep in mind that rate limits are subject to change, so it's advisable to exercise caution regarding your usage. Additionally, note that rate limits may vary based on licenses (developer or business).\n\n### Error code `429`\n\nIf you surpass your rate limit, you'll encounter an error code `429`. Once you hit this limit, you'll observe that calls to the API will no longer be successful until the rate limit is reset.","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"18359845","team":2780078,"collectionId":"25e8fe02-2185-49bf-acdc-e25e0f3a2f47","publishedId":"2s9Ykt3dgs","public":true,"publicUrl":"https://documenter-api.postman.tech/view/18359845/2s9Ykt3dgs","privateUrl":"https://go.postman.co/documentation/18359845-25e8fe02-2185-49bf-acdc-e25e0f3a2f47","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":"Dive into the world of movie magic with our detailed TMDb API documentation. Discover how to seamlessly integrate and leverage the power of The Movie Database to access a wealth of cinematic information. "},{"name":"title","value":"The Movie Database (TMDb) API Documentation"}],"appearance":{"default":"system_default","themes":[{"name":"dark","logo":null,"colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":null,"colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.11.6","publishDate":"2023-12-27T13:03:46.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"The Movie Database (TMDb) API Documentation","description":"Dive into the world of movie magic with our detailed TMDb API documentation. Discover how to seamlessly integrate and leverage the power of The Movie Database to access a wealth of cinematic information. "},"logos":{"logoLight":null,"logoDark":null}},"statusCode":200},"environments":[{"name":"The Movie DB API","id":"b7b31e6d-6fcc-4431-9c62-368f79f3f6a0","owner":"18359845","values":[{"enabled":true,"key":"value","value":"","type":"secret"},{"enabled":true,"key":"key","value":"","type":"secret"},{"enabled":true,"key":"in","value":"","type":"secret"}],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/5459719cbe3b8299d8163525a1904266a702cd9c3e15565695fb5f36a7281c6c","favicon":""},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"The Movie DB API","value":"18359845-b7b31e6d-6fcc-4431-9c62-368f79f3f6a0"}],"canonicalUrl":"https://documenter.gw.postman.com/view/metadata/2s9Ykt3dgs"}