### Review Content Example Source: https://developer.themoviedb.org/reference/tv-series-reviews Illustrates the structure and example content for a review, including text, creation date, and URL. ```json { "content": { "type": "string", "example": "I started watching when it came out as I heard that fans of LOTR also liked this. I stopped watching after Season 1 as I was devastated lol kinda. Only 2015 I decided to continue watching and got addicted like it seemed complicated at first, too many stories and characters. I even used a guide from internet like family tree per house while watching or GOT wiki so I can have more background on the characters. For a TV series, this show can really take you to a different world and never knowing what will happen. It is very daring that any time anybody can just die (I learned not to be attached and have accepted that they will all die so I won't be devastated hehe). I have never read the books but the show is entertaining and you will really root for your faves and really hate on those you hate. \r\n\r\nFantasy, action, drama, comedy, love...and lots of surprises!" }, "created_at": { "type": "string", "example": "2017-02-20T05:47:28.872Z" }, "id": { "type": "string", "example": "58aa82f09251416f92006a3a" }, "updated_at": { "type": "string", "example": "2021-06-23T15:57:54.649Z" }, "url": { "type": "string", "example": "https://www.themoviedb.org/review/58aa82f09251416f92006a3a" } } ``` -------------------------------- ### Example Movie/Series Description Source: https://developer.themoviedb.org/reference/tv-series-on-the-air-list Illustrates the structure of the 'example' field for a movie or series description. ```json "example": "To exact vengeance, a young woman infiltrates the household of an influential family as a housemaid to expose their dirty secrets. However, love will get in the way of her revenge plot." ``` -------------------------------- ### Create List Response Example Source: https://developer.themoviedb.org/reference/list-create This is an example of a successful response when creating a new list. It confirms the creation and provides the new list's ID. ```json { "status_message": "The item/record was created successfully.", "success": true, "status_code": 1, "list_id": 5861 } ``` -------------------------------- ### User Object Example Source: https://developer.themoviedb.org/reference/tv-series-reviews Provides an example of the user object structure, including username, avatar path, and rating. ```json { "username": { "type": "string", "example": "lmao7" }, "avatar_path": { "type": "string", "example": "/ekmYOUU4tfx9zGGadjRdE7UPce.jpg" }, "rating": { "type": "integer", "example": 9, "default": 0 } } ``` -------------------------------- ### Create List Request Example Source: https://developer.themoviedb.org/reference/list-create This is an example of the JSON body required to create a new list. It includes the list's name, description, and language. ```json { "name": "This is my awesome test list.", "description": "Just an awesome list.", "language": "en" } ``` -------------------------------- ### Example Poster Path Field Source: https://developer.themoviedb.org/reference/tv-series-on-the-air-list Defines the structure for the 'poster_path' field, including its type and an example value. ```json "poster_path": { "type": "string", "example": "/aoAZgnmMzY9vVy9VWnO3U5PZENh.jpg" } ``` -------------------------------- ### Example Watch Provider Data Source: https://developer.themoviedb.org/reference/tv-season-watch-providers This snippet shows an example of the data structure for watch providers, including flatrate options for a specific region. ```json "flatrate": [ { "logo_path": "/jbe4gVSfRlbPTdESXhEKpornsfu.jpg", "provider_id": 1899, "provider_name": "HBO Max", "display_priority": 44 } ] } ``` -------------------------------- ### TV Season Watch Providers Schema Example Source: https://developer.themoviedb.org/reference/tv-season-watch-providers This snippet shows an example of the structure for watch providers, including 'buy' and 'flatrate' options for a specific country. ```json { "type": "integer", "example": 505, "default": 0 }, "provider_name": { "type": "string", "example": "Player" }, "display_priority": { "type": "integer", "example": 10, "default": 0 } } }, "buy": { "type": "array", "items": { "type": "object", "properties": { "logo_path": { "type": "string", "example": "/seGSXajazLMCKGB5hnRCidtjay1.jpg" }, "provider_id": { "type": "integer", "example": 10, "default": 0 }, "provider_name": { "type": "string", "example": "Amazon Video" }, "display_priority": { "type": "integer", "example": 27, "default": 0 } } } } } }, "PT": { "type": "object", "properties": { "link": { "type": "string", "example": "https://www.themoviedb.org/tv/1399-game-of-thrones/watch?locale=PT" }, "buy": { "type": "array", "items": { "type": "object", "properties": { "logo_path": { "type": "string", "example": "/seGSXajazLMCKGB5hnRCidtjay1.jpg" }, "provider_id": { "type": "integer", "example": 10, "default": 0 }, "provider_name": { "type": "string", "example": "Amazon Video" }, "display_priority": { "type": "integer", "example": 43, "default": 0 } } } }, "flatrate": { "type": "array", "items": { "type": "object", "properties": { "logo_path": { "type": "string", "example": "/jbe4gVSfRlbPTdESXhEKpornsfu.jpg" }, "provider_id": { "type": "integer", "example": 1899, "default": 0 }, "provider_name": { "type": "string", "example": "HBO Max" }, "display_priority": { "type": "integer", "example": 32, "default": 0 } } } } } }, "PY": { ``` -------------------------------- ### OpenAPI Definition Example: ID and Adult Fields Source: https://developer.themoviedb.org/reference/changes-tv-list Shows the OpenAPI definition for 'id' and 'adult' fields, including their type, example, and default values. ```json { "id": { "type": "integer", "example": 225591, "default": 0 }, "adult": { "type": "boolean", "example": false, "default": true } } ``` -------------------------------- ### Get Movie Changes Source: https://developer.themoviedb.org/reference/movie-changes Retrieves the recent changes for a specific movie. You can filter changes by start and end dates and paginate through the results. ```APIDOC ## GET /3/movie/{movie_id}/changes ### Description Get the recent changes for a movie. ### Method GET ### Endpoint /3/movie/{movie_id}/changes ### Parameters #### Path Parameters - **movie_id** (integer) - Required - The ID of the movie to retrieve changes for. #### Query Parameters - **end_date** (string) - Optional - Filter changes up to this date (YYYY-MM-DD). - **page** (integer) - Optional - The page number for pagination. Defaults to 1. - **start_date** (string) - Optional - Filter changes from this date (YYYY-MM-DD). ### Response #### Success Response (200) - **changes** (array) - An array of change objects. - **key** (string) - The type of change (e.g., 'images', 'plot_keywords'). - **items** (array) - An array of individual change items. - **id** (string) - The ID of the changed item. - **action** (string) - The action performed (e.g., 'added', 'deleted'). - **time** (string) - The timestamp of the change. - **iso_639_1** (string) - The ISO 639-1 language code, if applicable. - **iso_3166_1** (string) - The ISO 3166-1 country code, if applicable. - **value** (object) - An object containing details about the changed value. ### Request Example ```json { "example": "" } ``` ### Response Example ```json { "changes": [ { "key": "images", "items": [ { "id": "643197b96dea3a00d4377270", "action": "added", "time": "2023-04-08 16:35:05 UTC", "iso_639_1": "", "iso_3166_1": "", "value": { "poster": { "file_path": "/s9ZrHprviFCx3azfWNBtt1LPSnL.jpg" } } } ] }, { "key": "plot_keywords", "items": [ { "id": "6431bb5d8289a000b73bd64d", "action": "added", "time": "2023-04-08 19:07:09 UTC", "iso_639_1": "", "iso_3166_1": "", "value": { "name": "breaking the fourth wall", "id": 11687 } } ] } ] } ``` ``` -------------------------------- ### cURL Request Example Source: https://developer.themoviedb.org/reference This snippet demonstrates how to make a GET request to the TMDB API's authentication endpoint using cURL. Ensure you have the correct API key and accept header. ```shell curl --request GET \ --url https://api.themoviedb.org/3/authentication \ --header 'accept: application/json' ``` -------------------------------- ### GET /movie/{movie_id}/watch/providers Source: https://developer.themoviedb.org/reference/tv-series-watch-providers Get the streaming providers for a specific movie. ```APIDOC ## GET /movie/{movie_id}/watch/providers ### Description Retrieves the streaming providers available for a specific movie, broken down by country. ### Method GET ### Endpoint /movie/{movie_id}/watch/providers ### Path Parameters - **movie_id** (integer) - Required - The ID of the movie. ### Query Parameters - **language** (string) - Optional - The ISO 639-1 language code to translate the names of the providers into. - **watch_region** (string) - Optional - The two-letter country code of the region you are interested in. ### Response #### Success Response (200) - **results** (object) - An object where keys are country codes (e.g., "US", "IT"). Each country object contains: - **link** (string) - The URL to watch the movie in that region. - **buy** (array) - A list of providers where the movie can be bought. - **rent** (array) - A list of providers where the movie can be rented. - **flatrate** (array) - A list of providers where the movie is available for streaming (flatrate). - Each provider object in these arrays contains: - **logo_path** (string) - The path to the provider's logo. - **provider_id** (integer) - The ID of the provider. - **provider_name** (string) - The name of the provider. - **display_priority** (integer) - The display priority of the provider. #### Response Example ```json { "results": { "US": { "link": "https://www.themoviedb.org/movie/157-fight-club/watch?locale=US", "buy": [ { "logo_path": "/tb9f5f10f13.jpg", "provider_id": 2, "provider_name": "Apple iTunes", "display_priority": 5 } ], "flatrate": [ { "logo_path": "/9k9n1f0f13.jpg", "provider_id": 337, "provider_name": "Amazon Prime Video", "display_priority": 1 } ] }, "IT": { "link": "https://www.themoviedb.org/movie/157-fight-club/watch?locale=IT", "buy": [ { "logo_path": "/cksgBjTHV3rzAVaO2zUyS1mH4Ke.jpg", "provider_id": 40, "provider_name": "Chili", "display_priority": 11 } ], "flatrate": [ { "logo_path": "/fBHHXKC34ffxAsQvDe0ZJbvmTEQ.jpg", "provider_id": 29, "provider_name": "Sky Go", "display_priority": 8 } ] } } } ``` ``` -------------------------------- ### Create Session Request Example Source: https://developer.themoviedb.org/reference/authentication-create-session-from-v4-token This example demonstrates the JSON payload required to initiate a session creation request using a v4 access token. Ensure the access token is user-authenticated. ```json { "access_token": "eyK0eXAiOiJAV1QiLCJhbGciOiUIUzI1NiJ9.eyJhdWQiOiI0Ozc2YzA1ZTg4YTY1Yzk0MjFjZDI1NmBiYzRiNGE0NyIsInN1YiI6IjRiYzg4OTJhMDE3YTNjMGY5MjAwMDAwMiIsInNjb3BlayI6WyJhcGlfcmVhZCJdLCL2ZXJzaW9uIjoxfQ.Bn660W0Vi-_AI5HvwIEqtc2s5mAXDknBnTrUREZYH7A" } ``` -------------------------------- ### GET /movie/{movie_id}/watch/providers Source: https://developer.themoviedb.org/reference/tv-series-watch-providers Get the streaming providers for a specific movie. ```APIDOC ## GET /movie/{movie_id}/watch/providers ### Description Retrieves the streaming providers for a specific movie, including where to watch it by subscription, rent, or buy. ### Method GET ### Endpoint /movie/{movie_id}/watch/providers ### Path Parameters - **movie_id** (integer) - Required - The ID of the movie. ### Query Parameters - **language** (string) - Optional - The ISO 639-1 language code to translate the output to. - **watch_region** (string) - Optional - The country code (ISO 3166-1) to filter results by. ### Response #### Success Response (200) - **results** (object) - An object where keys are country codes (e.g., 'US', 'BR'). Each country object contains: - **link** (string) - The URL to the provider's page for the movie. - **flatrate** (array) - List of providers offering the movie as part of a subscription. - **rent** (array) - List of providers offering the movie for rent. - **buy** (array) - List of providers offering the movie for purchase. Each provider object within these arrays contains `logo_path`, `provider_id`, `provider_name`, and `display_priority`. #### Response Example ```json { "results": { "US": { "link": "https://www.themoviedb.org/movie/11-fight-club/watch?locale=US", "flatrate": [ { "logo_path": "/97zZf732f4p1f9f4f4f4f4f4f4f.jpg", "provider_id": 337, "provider_name": "Amazon Prime Video", "display_priority": 1 } ], "rent": [ { "logo_path": "/peURmM5vysK6x5y02p7a3w0f20.jpg", "provider_id": 8, "provider_name": "Apple TV", "display_priority": 1 } ], "buy": [ { "logo_path": "/peURmM5vysK6x5y02p7a3w0f20.jpg", "provider_id": 8, "provider_name": "Apple TV", "display_priority": 1 } ] } } } ``` ``` -------------------------------- ### Create Session Response Example Source: https://developer.themoviedb.org/reference/authentication-create-session-from-v4-token This is a successful response example after creating a session from a v4 token. It includes a success flag and the newly generated session ID. ```json { "success": true, "session_id": "2629f70fb498edc263a0adb99118ac41f0053e8c" } ``` -------------------------------- ### GET /tv/{tv_id}/watch/providers Source: https://developer.themoviedb.org/reference/tv-series-watch-providers Get the streaming providers for a specific TV show. ```APIDOC ## GET /tv/{tv_id}/watch/providers ### Description Retrieves the streaming providers available for a specific TV show, broken down by country. ### Method GET ### Endpoint /tv/{tv_id}/watch/providers ### Path Parameters - **tv_id** (integer) - Required - The ID of the TV show. ### Query Parameters - **language** (string) - Optional - The ISO 639-1 language code to translate the names of the providers into. - **watch_region** (string) - Optional - The two-letter country code of the region you are interested in. ### Response #### Success Response (200) - **results** (object) - An object where keys are country codes (e.g., "US", "IT"). Each country object contains: - **link** (string) - The URL to watch the TV show in that region. - **buy** (array) - A list of providers where the TV show can be bought. - **rent** (array) - A list of providers where the TV show can be rented. - **flatrate** (array) - A list of providers where the TV show is available for streaming (flatrate). - Each provider object in these arrays contains: - **logo_path** (string) - The path to the provider's logo. - **provider_id** (integer) - The ID of the provider. - **provider_name** (string) - The name of the provider. - **display_priority** (integer) - The display priority of the provider. #### Response Example ```json { "results": { "US": { "link": "https://www.themoviedb.org/tv/1399-game-of-thrones/watch?locale=US", "buy": [ { "logo_path": "/xEPXbwbfABzPrUTWbgtDFH1NOa.jpg", "provider_id": 629, "provider_name": "OSN", "display_priority": 12 } ], "flatrate": [ { "logo_path": "/9k9n1f0f13.jpg", "provider_id": 337, "provider_name": "Amazon Prime Video", "display_priority": 1 } ] }, "IT": { "link": "https://www.themoviedb.org/tv/1399-game-of-thrones/watch?locale=IT", "buy": [ { "logo_path": "/cksgBjTHV3rzAVaO2zUyS1mH4Ke.jpg", "provider_id": 40, "provider_name": "Chili", "display_priority": 11 } ], "flatrate": [ { "logo_path": "/fBHHXKC34ffxAsQvDe0ZJbvmTEQ.jpg", "provider_id": 29, "provider_name": "Sky Go", "display_priority": 8 } ] }, "JM": { "link": "https://www.themoviedb.org/tv/1399-game-of-thrones/watch?locale=JM", "flatrate": [ { "logo_path": "/Ajqyt5aNxNGjmF9uOfxArGrdf3X.jpg", "provider_id": 384, "provider_name": "Flow", "display_priority": 1 } ] } } } ``` ``` -------------------------------- ### GET /tv/{tv_id}/watch/providers Source: https://developer.themoviedb.org/reference/tv-series-watch-providers Get the streaming providers for a specific TV show. ```APIDOC ## GET /tv/{tv_id}/watch/providers ### Description Retrieves the streaming providers for a specific TV show, including where to watch it by subscription, rent, or buy. ### Method GET ### Endpoint /tv/{tv_id}/watch/providers ### Path Parameters - **tv_id** (integer) - Required - The ID of the TV show. ### Query Parameters - **language** (string) - Optional - The ISO 639-1 language code to translate the output to. - **watch_region** (string) - Optional - The country code (ISO 3166-1) to filter results by. ### Response #### Success Response (200) - **results** (object) - An object where keys are country codes (e.g., 'US', 'BR'). Each country object contains: - **link** (string) - The URL to the provider's page for the TV show. - **flatrate** (array) - List of providers offering the TV show as part of a subscription. - **rent** (array) - List of providers offering the TV show for rent. - **buy** (array) - List of providers offering the TV show for purchase. Each provider object within these arrays contains `logo_path`, `provider_id`, `provider_name`, and `display_priority`. #### Response Example ```json { "results": { "BR": { "link": "https://www.themoviedb.org/tv/1399-game-of-thrones/watch?locale=BR", "flatrate": [ { "logo_path": "/Ajqyt5aNxNGjmF9uOfxArGrdf3X.jpg", "provider_id": 384, "provider_name": "HBO Max", "display_priority": 7 } ] } } } ``` ``` -------------------------------- ### Movie Watch Providers Schema Example Source: https://developer.themoviedb.org/reference/movie-watch-providers This snippet shows an example of the structure for movie watch providers, including flatrate, rent, and buy options for a specific country. ```json { "link": "https://www.themoviedb.org/movie/550-fight-club/watch?locale=CO", "buy": [ { "logo_path": "/tbEdFQDwx5LEVr8WpSeXQSIirVq.jpg", "provider_id": 3, "provider_name": "Google Play Movies", "display_priority": 3 } ], "flatrate": [ { "logo_path": "/emthp39XA2YScoYL1p0sdbAH2WA.jpg", "provider_id": 119, "provider_name": "Amazon Prime Video", "display_priority": 2 } ], "rent": [ { "logo_path": "/tbEdFQDwx5LEVr8WpSeXQSIirVq.jpg", "provider_id": 3, "provider_name": "Google Play Movies", "display_priority": 4 } ] } ``` -------------------------------- ### People - Get Combined Credits Source: https://developer.themoviedb.org/reference/tv-series-aggregate-credits Get the combined credits for a person. This includes movies and TV shows. ```APIDOC ## GET /person/{person_id}/combined_credits ### Description Retrieves all of a person's credits, including movies and TV shows they have been a part of. ### Method GET ### Endpoint /person/{person_id}/combined_credits ### Parameters #### Path Parameters - **person_id** (integer) - Required - The ID of the person to retrieve credits for. ### Response #### Success Response (200) - **cast** (array) - List of cast credits. - **crew** (array) - List of crew credits. #### Response Example { "cast": [ { "adult": false, "backdrop_path": "/q2F0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0.jpg", "genre_ids": [18, 36], "id": 12345, "original_language": "en", "original_title": "Example Movie", "overview": "This is an example movie.", "popularity": 10.5, "poster_path": "/p0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0.jpg", "release_date": "2023-01-01", "title": "Example Movie", "video": false, "vote_average": 7.5, "vote_count": 100, "character": "Main Character", "order": 0 } ], "crew": [ { "adult": false, "backdrop_path": "/q2f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0.jpg", "genre_ids": [18, 36], "id": 67890, "original_language": "en", "original_title": "Example TV Show", "overview": "This is an example TV show.", "popularity": 8.2, "poster_path": "/p0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0.jpg", "release_date": "2023-01-01", "title": "Example TV Show", "video": false, "vote_average": 8.0, "vote_count": 200, "department": "Directing", "job": "Director" } ] } ``` -------------------------------- ### Create Session Response Example Source: https://developer.themoviedb.org/reference/authentication-create-session-from-login This is a successful response after validating a request token with login credentials. It confirms the session's success and provides an expiration time and the validated request token. ```json { "success": true, "expires_at": "2018-07-24 04:10:26 UTC", "request_token": "1531f1a558c8357ce8990cf887ff196e8f5402ec" } ``` -------------------------------- ### Remove Movie Response Example Source: https://developer.themoviedb.org/reference/list-remove-movie This is an example of a successful response when a movie is removed from a list. It confirms the operation with a status code and message. ```json { "status_code": 13, "status_message": "The item/record was deleted successfully." } ``` -------------------------------- ### Get Configuration Details Source: https://developer.themoviedb.org/reference/configuration-details Query the API for configuration details. This includes information about image URLs and sizes, as well as a list of keys that can be used to track changes. ```APIDOC ## GET /3/configuration ### Description Query the API configuration details. ### Method GET ### Endpoint /3/configuration ### Parameters ### Request Example ```json { "example": "request body" } ``` ### Response #### Success Response (200) - **images** (object) - Contains image-related configuration details. - **base_url** (string) - The base URL for images. - **secure_base_url** (string) - The secure base URL for images. - **backdrop_sizes** (array) - An array of available backdrop image sizes. - **logo_sizes** (array) - An array of available logo image sizes. - **poster_sizes** (array) - An array of available poster image sizes. - **profile_sizes** (array) - An array of available profile image sizes. - **still_sizes** (array) - An array of available still image sizes. - **change_keys** (array) - A list of keys that can be used to track changes. #### Response Example ```json { "images": { "base_url": "http://image.tmdb.org/t/p/", "secure_base_url": "https://image.tmdb.org/t/p/", "backdrop_sizes": [ "w300", "w780", "w1280", "original" ], "logo_sizes": [ "w45", "w92", "w154", "w185", "w300", "w500", "original" ], "poster_sizes": [ "w92", "w154", "w185", "w342", "w500", "w780", "original" ], "profile_sizes": [ "w45", "w185", "h632", "original" ], "still_sizes": [ "w92", "w185", "w300", "original" ] }, "change_keys": [ "adult", "air_date", "also_known_as", "alternative_titles", "biography", "birthday", "budget", "cast", "certifications", "character_names", "created_by", "crew", "deathday", "episode", "episode_number", "episode_run_time", "freebase_id", "freebase_mid", "general", "genres", "guest_stars", "homepage", "images", "imdb_id", "languages", "name", "network", "origin_country", "original_name", "original_title", "overview", "parts", "place_of_birth", "plot_keywords", "production_code", "production_companies", "production_countries", "releases", "revenue", "runtime", "season", "season_number", "season_regular", "spoken_languages", "status", "tagline", "title", "translations", "tvdb_id", "tvrage_id", "type", "video", "videos" ] } ``` ```