# TVApi All URIs are relative to *https://api.themoviedb.org/3* Method | HTTP request | Description ------------- | ------------- | ------------- [**delete_tv_rating**](TVApi.md#delete_tv_rating) | **delete** /tv/{tv_id}/rating | Delete Rating [**get_tv_account_states**](TVApi.md#get_tv_account_states) | **get** /tv/{tv_id}/account_states | Get Account States [**get_tv_airing_today_paginated**](TVApi.md#get_tv_airing_today_paginated) | **get** /tv/airing_today | Get TV Airing Today [**get_tv_alternative_titles_list**](TVApi.md#get_tv_alternative_titles_list) | **get** /tv/{tv_id}/alternative_titles | Get Alternative Titles [**get_tv_changes**](TVApi.md#get_tv_changes) | **get** /tv/{tv_id}/changes | Get Changes [**get_tv_content_ratings_list**](TVApi.md#get_tv_content_ratings_list) | **get** /tv/{tv_id}/content_ratings | Get Content Ratings [**get_tv_credits**](TVApi.md#get_tv_credits) | **get** /tv/{tv_id}/credits | Get Credits [**get_tv_details**](TVApi.md#get_tv_details) | **get** /tv/{tv_id} | Get Details [**get_tv_episode_groups**](TVApi.md#get_tv_episode_groups) | **get** /tv/{tv_id}/episode_groups | Get Episode Groups [**get_tv_external_ids**](TVApi.md#get_tv_external_ids) | **get** /tv/{tv_id}/external_ids | Get External IDs [**get_tv_images**](TVApi.md#get_tv_images) | **get** /tv/{tv_id}/images | Get Images [**get_tv_keywords_list**](TVApi.md#get_tv_keywords_list) | **get** /tv/{tv_id}/keywords | Get Keywords [**get_tv_latest_details**](TVApi.md#get_tv_latest_details) | **get** /tv/latest | Get Latest [**get_tv_on_the_air_paginated**](TVApi.md#get_tv_on_the_air_paginated) | **get** /tv/on_the_air | Get TV On The Air [**get_tv_popular_paginated**](TVApi.md#get_tv_popular_paginated) | **get** /tv/popular | Get Popular [**get_tv_recommendations_paginated**](TVApi.md#get_tv_recommendations_paginated) | **get** /tv/{tv_id}/recommendations | Get Recommendations [**get_tv_screened_theatrically**](TVApi.md#get_tv_screened_theatrically) | **get** /tv/{tv_id}/screened_theatrically | Get Screened Theatrically [**get_tv_similar_paginated**](TVApi.md#get_tv_similar_paginated) | **get** /tv/{tv_id}/similar | Get Similar TV Shows [**get_tv_top_rated_paginated**](TVApi.md#get_tv_top_rated_paginated) | **get** /tv/top_rated | Get Top Rated [**get_tv_translations_list**](TVApi.md#get_tv_translations_list) | **get** /tv/{tv_id}/translations | Get Translations [**get_tv_videos_list**](TVApi.md#get_tv_videos_list) | **get** /tv/{tv_id}/videos | Get Videos [**post_tv_rating**](TVApi.md#post_tv_rating) | **post** /tv/{tv_id}/rating | Rate TV Show ## delete_tv_rating > crate::models::StatusCodeMessage delete_tv_rating(tv_id, content_type, guest_session_id, session_id) Delete Rating Remove your rating for a TV show. A valid session or guest session ID is required. You can read more about how this works [here](#docTextSection:NSZtgz7zptsiLYxXZ). ### Parameters Name | Type | Description | Required | Notes ------------- | ------------- | ------------- | ------------- | ------------- **tv_id** | **i32** | | Required | **content_type** | **String** | | Required | [default to application/json;charset=utf-8] **guest_session_id** | **String** | | | **session_id** | **String** | | | ### Return type [**crate::models::StatusCodeMessage**](StatusCodeMessage.md) ### Authorization [api_key](../README.md#api_key) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) ## get_tv_account_states > crate::models::AccountStates get_tv_account_states(tv_id, language, guest_session_id, session_id) Get Account States Grab the following account states for a session: - TV show rating - If it belongs to your watchlist - If it belongs to your favourite list ### Parameters Name | Type | Description | Required | Notes ------------- | ------------- | ------------- | ------------- | ------------- **tv_id** | **i32** | | Required | **language** | **String** | Pass a ISO 639-1 value to display translated data for the fields that support it. | | [default to <>] **guest_session_id** | **String** | | | **session_id** | **String** | | | ### Return type [**crate::models::AccountStates**](AccountStates.md) ### Authorization [api_key](../README.md#api_key) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) ## get_tv_airing_today_paginated > crate::models::TvPaginated get_tv_airing_today_paginated(language, page) Get TV Airing Today Get a list of TV shows that are airing today. This query is purely day based as we do not currently support airing times. You can specify a [timezone](endpoint:KQ4CDdEoWKJYLkrhS) to offset the day calculation. Without a specified timezone, this query defaults to EST (Eastern Time UTC-05:00). ### Parameters Name | Type | Description | Required | Notes ------------- | ------------- | ------------- | ------------- | ------------- **language** | **String** | Pass a ISO 639-1 value to display translated data for the fields that support it. | | [default to <>] **page** | **i32** | Specify which page to query. | | [default to 1] ### Return type [**crate::models::TvPaginated**](TvPaginated.md) ### Authorization [api_key](../README.md#api_key) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) ## get_tv_alternative_titles_list > crate::models::TvAlternativeTitlesList get_tv_alternative_titles_list(tv_id, language) Get Alternative Titles Returns all of the alternative titles for a TV show. ### Parameters Name | Type | Description | Required | Notes ------------- | ------------- | ------------- | ------------- | ------------- **tv_id** | **i32** | | Required | **language** | **String** | Pass a ISO 639-1 value to display translated data for the fields that support it. | | [default to <>] ### Return type [**crate::models::TvAlternativeTitlesList**](TvAlternativeTitlesList.md) ### Authorization [api_key](../README.md#api_key) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) ## get_tv_changes > crate::models::ChangeDetails get_tv_changes(tv_id, start_date, end_date, page) Get Changes Get the changes for a TV show. By default only the last 24 hours are returned. You can query up to 14 days in a single query by using the `start_date` and `end_date` query parameters. TV show changes are different than movie changes in that there are some edits on seasons and episodes that will create a change entry at the show level. These can be found under the season and episode keys. These keys will contain a `series_id` and `episode_id`. You can use the [season changes](#endpoint:ZqhtyQbJ4YXz8RSya) and [episode changes](#endpoint:FpqrhBzgf2RJv4bHC) methods to look these up individually. ### Parameters Name | Type | Description | Required | Notes ------------- | ------------- | ------------- | ------------- | ------------- **tv_id** | **i32** | | Required | **start_date** | **String** | Filter the results with a start date. | | **end_date** | **String** | Filter the results with a end date. | | **page** | **i32** | Specify which page to query. | | [default to 1] ### Return type [**crate::models::ChangeDetails**](ChangeDetails.md) ### Authorization [api_key](../README.md#api_key) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) ## get_tv_content_ratings_list > crate::models::RatingsList get_tv_content_ratings_list(tv_id, language) Get Content Ratings Get the list of content ratings (certifications) that have been added to a TV show. ### Parameters Name | Type | Description | Required | Notes ------------- | ------------- | ------------- | ------------- | ------------- **tv_id** | **i32** | | Required | **language** | **String** | Pass a ISO 639-1 value to display translated data for the fields that support it. | | [default to <>] ### Return type [**crate::models::RatingsList**](RatingsList.md) ### Authorization [api_key](../README.md#api_key) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) ## get_tv_credits > crate::models::Credits get_tv_credits(tv_id, language) Get Credits Get the credits (cast and crew) that have been added to a TV show. ### Parameters Name | Type | Description | Required | Notes ------------- | ------------- | ------------- | ------------- | ------------- **tv_id** | **i32** | | Required | **language** | **String** | Pass a ISO 639-1 value to display translated data for the fields that support it. | | [default to <>] ### Return type [**crate::models::Credits**](Credits.md) ### Authorization [api_key](../README.md#api_key) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) ## get_tv_details > crate::models::TvDetails get_tv_details(tv_id, include_image_language, language, append_to_response) Get Details Get the primary TV show details by id. Supports `append_to_response`. Read more about this [here](#docTextSection:JdZq8ctmcxNqyLQjp). ### Parameters Name | Type | Description | Required | Notes ------------- | ------------- | ------------- | ------------- | ------------- **tv_id** | **i32** | | Required | **include_image_language** | **String** | Pass a ISO 639-1 value to get additional images (cf. https://developers.themoviedb.org/3/getting-started/image-languages). | | **language** | **String** | Pass a ISO 639-1 value to display translated data for the fields that support it. | | [default to <>] **append_to_response** | **String** | Append requests within the same namespace to the response. | | ### Return type [**crate::models::TvDetails**](TvDetails.md) ### Authorization [api_key](../README.md#api_key) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) ## get_tv_episode_groups > crate::models::EpisodeGroupList get_tv_episode_groups(tv_id, language) Get Episode Groups Get all of the episode groups that have been created for a TV show. ### Parameters Name | Type | Description | Required | Notes ------------- | ------------- | ------------- | ------------- | ------------- **tv_id** | **i32** | | Required | **language** | **String** | Pass a ISO 639-1 value to display translated data for the fields that support it. | | [default to <>] ### Return type [**crate::models::EpisodeGroupList**](EpisodeGroupList.md) ### Authorization [api_key](../README.md#api_key) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) ## get_tv_external_ids > crate::models::ExternalIds get_tv_external_ids(tv_id, language) Get External IDs Get the external ids for a TV show. We currently support the following external sources. | **External Sources** | | -------------------- | | IMDB ID | | Freebase MID | | Freebase ID | | TVDB ID | | TVRage ID | ### Parameters Name | Type | Description | Required | Notes ------------- | ------------- | ------------- | ------------- | ------------- **tv_id** | **i32** | | Required | **language** | **String** | Pass a ISO 639-1 value to display translated data for the fields that support it. | | [default to <>] ### Return type [**crate::models::ExternalIds**](ExternalIds.md) ### Authorization [api_key](../README.md#api_key) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) ## get_tv_images > crate::models::Images get_tv_images(tv_id, include_image_language, language) Get Images Get the images that belong to a TV show. Querying images with a `language` parameter will filter the results. If you want to include a fallback language (especially useful for backdrops) you can use the `include_image_language` parameter. This should be a comma seperated value like so: `include_image_language=en,null`. ### Parameters Name | Type | Description | Required | Notes ------------- | ------------- | ------------- | ------------- | ------------- **tv_id** | **i32** | | Required | **include_image_language** | **String** | Pass a ISO 639-1 value to get additional images (cf. https://developers.themoviedb.org/3/getting-started/image-languages). | | **language** | **String** | Pass a ISO 639-1 value to display translated data for the fields that support it. | | [default to <>] ### Return type [**crate::models::Images**](Images.md) ### Authorization [api_key](../README.md#api_key) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) ## get_tv_keywords_list > crate::models::KeywordsList get_tv_keywords_list(tv_id) Get Keywords Get the keywords that have been added to a TV show. ### Parameters Name | Type | Description | Required | Notes ------------- | ------------- | ------------- | ------------- | ------------- **tv_id** | **i32** | | Required | ### Return type [**crate::models::KeywordsList**](KeywordsList.md) ### Authorization [api_key](../README.md#api_key) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) ## get_tv_latest_details > crate::models::TvDetails get_tv_latest_details(language) Get Latest Get the most newly created TV show. This is a live response and will continuously change. ### Parameters Name | Type | Description | Required | Notes ------------- | ------------- | ------------- | ------------- | ------------- **language** | **String** | Pass a ISO 639-1 value to display translated data for the fields that support it. | | [default to <>] ### Return type [**crate::models::TvDetails**](TvDetails.md) ### Authorization [api_key](../README.md#api_key) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) ## get_tv_on_the_air_paginated > crate::models::TvPaginated get_tv_on_the_air_paginated(language, page) Get TV On The Air Get a list of shows that are currently on the air. This query looks for any TV show that has an episode with an air date in the next 7 days. ### Parameters Name | Type | Description | Required | Notes ------------- | ------------- | ------------- | ------------- | ------------- **language** | **String** | Pass a ISO 639-1 value to display translated data for the fields that support it. | | [default to <>] **page** | **i32** | Specify which page to query. | | [default to 1] ### Return type [**crate::models::TvPaginated**](TvPaginated.md) ### Authorization [api_key](../README.md#api_key) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) ## get_tv_popular_paginated > crate::models::TvPaginated get_tv_popular_paginated(language, page) Get Popular Get a list of the current popular TV shows on TMDb. This list updates daily. ### Parameters Name | Type | Description | Required | Notes ------------- | ------------- | ------------- | ------------- | ------------- **language** | **String** | Pass a ISO 639-1 value to display translated data for the fields that support it. | | [default to <>] **page** | **i32** | Specify which page to query. | | [default to 1] ### Return type [**crate::models::TvPaginated**](TvPaginated.md) ### Authorization [api_key](../README.md#api_key) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) ## get_tv_recommendations_paginated > crate::models::TvPaginated get_tv_recommendations_paginated(tv_id, language, page) Get Recommendations Get the list of TV show recommendations for this item. ### Parameters Name | Type | Description | Required | Notes ------------- | ------------- | ------------- | ------------- | ------------- **tv_id** | **i32** | | Required | **language** | **String** | Pass a ISO 639-1 value to display translated data for the fields that support it. | | [default to <>] **page** | **i32** | Specify which page to query. | | [default to 1] ### Return type [**crate::models::TvPaginated**](TvPaginated.md) ### Authorization [api_key](../README.md#api_key) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) ## get_tv_screened_theatrically > crate::models::SeasonEpisodeList get_tv_screened_theatrically(tv_id) Get Screened Theatrically Get a list of seasons or episodes that have been screened in a film festival or theatre. ### Parameters Name | Type | Description | Required | Notes ------------- | ------------- | ------------- | ------------- | ------------- **tv_id** | **i32** | | Required | ### Return type [**crate::models::SeasonEpisodeList**](SeasonEpisodeList.md) ### Authorization [api_key](../README.md#api_key) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) ## get_tv_similar_paginated > crate::models::TvPaginated get_tv_similar_paginated(tv_id, language, page) Get Similar TV Shows Get a list of similar TV shows. These items are assembled by looking at keywords and genres. ### Parameters Name | Type | Description | Required | Notes ------------- | ------------- | ------------- | ------------- | ------------- **tv_id** | **i32** | | Required | **language** | **String** | Pass a ISO 639-1 value to display translated data for the fields that support it. | | [default to <>] **page** | **i32** | Specify which page to query. | | [default to 1] ### Return type [**crate::models::TvPaginated**](TvPaginated.md) ### Authorization [api_key](../README.md#api_key) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) ## get_tv_top_rated_paginated > crate::models::TvPaginated get_tv_top_rated_paginated(language, page) Get Top Rated Get a list of the top rated TV shows on TMDb. ### Parameters Name | Type | Description | Required | Notes ------------- | ------------- | ------------- | ------------- | ------------- **language** | **String** | Pass a ISO 639-1 value to display translated data for the fields that support it. | | [default to <>] **page** | **i32** | Specify which page to query. | | [default to 1] ### Return type [**crate::models::TvPaginated**](TvPaginated.md) ### Authorization [api_key](../README.md#api_key) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) ## get_tv_translations_list > crate::models::TranslationsList get_tv_translations_list(tv_id, language) Get Translations Get a list of the translations that exist for a TV show. ### Parameters Name | Type | Description | Required | Notes ------------- | ------------- | ------------- | ------------- | ------------- **tv_id** | **i32** | | Required | **language** | **String** | Pass a ISO 639-1 value to display translated data for the fields that support it. | | [default to <>] ### Return type [**crate::models::TranslationsList**](TranslationsList.md) ### Authorization [api_key](../README.md#api_key) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) ## get_tv_videos_list > crate::models::VideosList get_tv_videos_list(tv_id, language) Get Videos Get the videos that have been added to a TV show. ### Parameters Name | Type | Description | Required | Notes ------------- | ------------- | ------------- | ------------- | ------------- **tv_id** | **i32** | | Required | **language** | **String** | Pass a ISO 639-1 value to display translated data for the fields that support it. | | [default to <>] ### Return type [**crate::models::VideosList**](VideosList.md) ### Authorization [api_key](../README.md#api_key) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) ## post_tv_rating > crate::models::StatusCodeMessage post_tv_rating(tv_id, content_type, guest_session_id, session_id, body) Rate TV Show Rate a TV show. A valid session or guest session ID is required. You can read more about how this works [here](#docTextSection:NSZtgz7zptsiLYxXZ). ### Parameters Name | Type | Description | Required | Notes ------------- | ------------- | ------------- | ------------- | ------------- **tv_id** | **i32** | | Required | **content_type** | **String** | | Required | [default to application/json;charset=utf-8] **guest_session_id** | **String** | | | **session_id** | **String** | | | **body** | [**ValueBody**](ValueBody.md) | | | ### Return type [**crate::models::StatusCodeMessage**](StatusCodeMessage.md) ### Authorization [api_key](../README.md#api_key) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)