Details
Get the top level details of a TV series by ID.
Get the top level details of a TV series by ID. Supports appending sub-resources in a single request via append_to_response.
async details<T extends readonly TVAppendToResponseNamespace[] = []>(
params: TVDetailsParams & { append_to_response?: T }
): Promise<T extends [] ? TVSeriesDetails : TVDetailsWithAppends<T>>TMDB Reference: TV Series Details
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
series_id | number | ✅ | TMDB TV series identifier. |
append_to_response | TVAppendToResponseNamespace[] | ❌ | Sub-resources to append to the response. |
language | Language | ❌ | Language for localized results. Defaults to en-US. |
include_image_language | (Language | "null")[] | ❌ | Extra languages for an appended images block. Serialized comma-separated. |
When you append images and pass a language, TMDB treats the language as a filter on the appended block and
returns only images tagged with it — often nothing at all. Pass include_image_language to get logos and untagged
backdrops:
const show = await tmdb.tv_series.details({
series_id: 1396,
language: "it-IT",
append_to_response: ["images"],
include_image_language: ["null", "en"], // untagged + English
});
// 108 posters, 124 backdrops, 9 logos
// without include_image_language: 0 / 0 / 0Returns
TVSeriesDetails when no appends are provided,
or TVDetailsWithAppends<T> when append_to_response is specified.
Example
// Basic details
const show = await tmdb.tv_series.details({ series_id: 1396 });
console.log(show.name); // "Breaking Bad"
// With appended data
const show = await tmdb.tv_series.details({
series_id: 1396,
append_to_response: ["credits", "videos", "content_ratings", "watch/providers"],
});
console.log(show.credits.cast);
console.log(show.videos.results);
console.log(show.content_ratings.results);
console.log(show["watch/providers"].results);