Videos
Get trailers, teasers, and clips for a TV season.
Get the videos that belong to a TV season.
async videos(params: TVSeasonVideosParams): Promise<TVSeasonVideos>TMDB Reference: TV Season Videos
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
series_id | number | ✅ | TMDB TV series identifier. |
season_number | number | ✅ | Season number within the TV series. |
language | Language | ❌ | Language for video metadata. Defaults to en-US. |
include_video_language | string | ❌ | Comma-separated ISO 639-1 codes of extra video languages to include (e.g. "it,en,null"). Without it, only videos tagged with language are returned. |
By default TMDB only returns videos tagged with language, which is often nothing for non-English languages. Pass include_video_language to widen the set, e.g. "it,en,null" for Italian, English and untagged videos.
Returns
Example
const { results } = await tmdb.tv_seasons.videos({
series_id: 1396,
season_number: 1,
});
const trailer = results.find((v) => v.type === "Trailer");
console.log(trailer?.key); // YouTube key