🍿 @lorenzopant/tmdb

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 tvSeries.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.tvSeries.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

Extends Credit (omitting credit_id) with the following fields:

Prop

Type

TVAggregateCreditsCrewItem

Extends Credit (omitting credit_id) with the following fields:

Prop

Type

TVCreditRole

Prop

Type

TVCreditJob

Prop

Type


TVExternalIDs

Prop

Type


TVImages

Prop

Type

TVImageItem

Extends ImageItem with an additional optional field:

Prop

Type


TVKeywords

Prop

Type


TVRecommendations

A PaginatedResponse<TVSeriesResultItem> of recommended TV shows.

See TVSeriesResultItem.


TVSimilar

A PaginatedResponse<TVSeriesResultItem> of similar TV shows.

See TVSeriesResultItem.


TVReviews

A PaginatedResponse<Review> of user reviews.


TVTranslations

Prop

Type

TVTranslationItem

Extends Translation with a data field.

Prop

Type

TVTranslationData

Prop

Type


TVVideos

Prop

Type


TVSeriesChanges

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


TVAlternativeTitles

Prop

Type


TVContentRatings

Prop

Type


TVEpisodeGroups

Prop

Type

TVEpisodeGroupItem

Prop

Type


TVScreenedTheatrically

Prop

Type

TVScreeningItem

Prop

Type


TVSeasonItem

Prop

Type


TVEpisodeItem

Prop

Type


TVSeriesLists

A PaginatedResponse<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

On this page