TV Series

Type definitions for TV series details, appended data, and query parameters.

These types represent the full TV series domain — details, appended sub-resources, and query parameters.

`TVSeriesDetails`

The complete representation of a TV show as returned by tv_series.details().

Prop

Type

`TVDetailsWithAppends<T>`

Extends TVSeriesDetails with one or more appended sub-resources. T is a readonly array of TVAppendToResponseNamespace keys.

const show: TVDetailsWithAppends<["credits", "keywords"]> = await tmdb.tv_series.details({
	series_id: 1396,
	append_to_response: ["credits", "keywords"],
});

`TVAppendToResponseNamespace`

Union of all valid keys that can be passed to append_to_response.

type TVAppendToResponseNamespace =
	| "credits"
	| "external_ids"
	| "images"
	| "keywords"
	| "recommendations"
	| "similar"
	| "translations"
	| "videos";

Additional Resources

Other types returned by tv series endpoints.

`TVCredits`

The latest season credit data. For aggregate credits across all seasons, see TVAggregateCredits.

Prop

Type

`TVAggregateCredits`

Aggregate cast and crew data across all seasons and episodes — the same view shown on the TMDB website.

Prop

Type

`TVAggregateCreditsCastItem`

Prop

Type

`TVAggregateCreditsCrewItem`

Prop

Type

`TVCreditRole`

Prop

Type

`TVCreditJob`

Prop

Type

`TVExternalIDs`

Prop

Type

`TVImages`

Prop

Type

`TVImageItem`

Extends ImageItem

Prop

Type

`TVKeywords`

Prop

Type

`TVRecommendations`

A PaginatedResponse<TVSeriesResultItem> of recommended TV shows. See PaginatedResponse.

`TVSimilar`

A PaginatedResponse<TVSeriesResultItem> of similar TV shows. See PaginatedResponse.

`TVReviews`

A PaginatedResponse<Review> of user reviews. See PaginatedResponse.

`TVTranslations`

A TranslationResults<TVTranslationData> collection of translations for a TV show.

`TVTranslationData`

Prop

Type

`TVVideos`

Prop

Type

`TVSeriesChanges`

Alias for Changes. Returns the change history for a TV show.

`TVAlternativeTitles`

Prop

Type

See AlternativeTitle

`TVContentRatings`

Prop

Type

See ContentRating

`TVEpisodeGroups`

Prop

Type

`TVEpisodeGroupItem`

Prop

Type

`TVScreenedTheatrically`

Prop

Type

`TVScreeningItem`

Prop

Type

`TVSeasonItem`

Prop

Type

`TVEpisodeItem`

Prop

Type

`TVSeriesLists`

A PaginatedResponse of TVSeriesListItem extended with an id field.

Prop

Type

`TVSeriesListItem`

Prop

Type

Parameters

`TVDetailsParams`

Prop

Type

`TVSeriesListParams`

Used by airing_today(), on_the_air(), popular(), and top_rated().

Prop

Type

`TVAggregateCreditsParams`

Prop

Type

`TVCreditsParams`

Prop

Type

`TVChangeParams`

Prop

Type

`TVImagesParams`

Prop

Type

`TVRecommendationsParams` / `TVSimilarParams` / `TVReviewsParams` / `TVSeriesListsParams`

Prop

Type

Movies

Type definitions for movie details, appended data, and query parameters.

TV Seasons

Type definitions for TV season details, appended data, and query parameters.