Videos
Get trailers, teasers, and clips for a TV episode.
Get the videos that belong to a TV episode, including trailers, teasers, and clips.
async videos(params: TVEpisodeVideosParams): Promise<TVEpisodeVideos>TMDB Reference: TV Episode Videos
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
series_id | number | ✅ | TMDB TV series identifier. |
season_number | number | ✅ | Season number within the TV series. |
episode_number | number | ✅ | Episode number within the season. |
language | Language | ❌ | Language for localized results. 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_episodes.videos({
series_id: 1396,
season_number: 1,
episode_number: 1,
});
const trailer = results.find((v) => v.type === "Trailer");
console.log(`https://www.youtube.com/watch?v=${trailer?.key}`);