Details

This endpoint get the details of a TV show.

GET /tv/{series_id}

Details

cURL

curl --request GET \
  --url https://api.themoviedb.org/3/tv/{series_id} \
  --header 'Authorization: Bearer <token>'

200

{
  "adult": false,
  "backdrop_path": "/jeP3It0ZPY3SKW3632qwLkkIZv3.jpg",
  "created_by": [
    {
      "id": 32568,
      "credit_id": "5253854019c29579402069da",
      "name": "Johnny Speight",
      "original_name": "Johnny Speight",
      "gender": 2,
      "profile_path": null
    }
  ],
  "episode_run_time": [
    30
  ],
  "first_air_date": "1966-06-06",
  "genres": [
    {
      "id": 35,
      "name": "Comedy"
    }
  ],
  "homepage": "https://www.bbc.com/historyofthebbc/anniversaries/june/till-death-us-do-part/",
  "id": 550,
  "in_production": false,
  "languages": [
    "en"
  ],
  "last_air_date": "1975-12-17",
  "last_episode_to_air": {
    "id": 31100,
    "name": "Unemployment",
    "overview": "Alf returns home after being laid off work to find a surprise birthday party with friends and family. Arguments about politics, Catholics and the Irish fill the night. A near fight between Alf and neighbor Wally Carry is interrupted when a telegram arrives from Else in Australia asking for a divorce",
    "vote_average": 0,
    "vote_count": 0,
    "air_date": "1975-12-17",
    "episode_number": 6,
    "episode_type": "finale",
    "production_code": "",
    "runtime": 30,
    "season_number": 7,
    "show_id": 550,
    "still_path": null
  },
  "name": "Till Death Us Do Part",
  "next_episode_to_air": null,
  "networks": [
    {
      "id": 4,
      "logo_path": "/uJjcCg3O4DMEjM0xtno9OWFciRP.png",
      "name": "BBC One",
      "origin_country": "GB"
    }
  ],
  "number_of_episodes": 49,
  "number_of_seasons": 7,
  "origin_country": [
    "GB"
  ],
  "original_language": "en",
  "original_name": "Till Death Us Do Part",
  "overview": "Following the chronicles of the East End working-class Garnett family, headed by patriarch Alf Garnett, a reactionary working-class man who holds racist and anti-socialist views.",
  "popularity": 13.707,
  "poster_path": "/5r8enLaWs3SnVoInZYsOLZgboki.jpg",
  "production_companies": [
    {
      "id": 3324,
      "logo_path": "/dqT3yOTlfJRmtvk52Ccd1O6dZ0A.png",
      "name": "BBC",
      "origin_country": "GB"
    }
  ],
  "production_countries": [
    {
      "iso_3166_1": "GB",
      "name": "United Kingdom"
    }
  ],
  "seasons": [
    {
      "air_date": "1965-07-22",
      "episode_count": 5,
      "id": 1692,
      "name": "Specials",
      "overview": "",
      "poster_path": null,
      "season_number": 0,
      "vote_average": 0
    },
    {
      "air_date": "1966-06-06",
      "episode_count": 7,
      "id": 1690,
      "name": "Series 1",
      "overview": "",
      "poster_path": null,
      "season_number": 1,
      "vote_average": 0
    },
    {
      "air_date": "1966-12-26",
      "episode_count": 10,
      "id": 1688,
      "name": "Series 2",
      "overview": "",
      "poster_path": null,
      "season_number": 2,
      "vote_average": 0
    },
    {
      "air_date": "1968-01-05",
      "episode_count": 7,
      "id": 1685,
      "name": "Series 3",
      "overview": "",
      "poster_path": null,
      "season_number": 3,
      "vote_average": 0
    },
    {
      "air_date": "1972-09-13",
      "episode_count": 6,
      "id": 1689,
      "name": "Series 4",
      "overview": "",
      "poster_path": null,
      "season_number": 4,
      "vote_average": 0
    },
    {
      "air_date": "1974-01-02",
      "episode_count": 7,
      "id": 1686,
      "name": "Series 5",
      "overview": "",
      "poster_path": null,
      "season_number": 5,
      "vote_average": 0
    },
    {
      "air_date": "1975-01-08",
      "episode_count": 6,
      "id": 1687,
      "name": "Series 6",
      "overview": "",
      "poster_path": null,
      "season_number": 6,
      "vote_average": 0
    },
    {
      "air_date": "1975-11-05",
      "episode_count": 6,
      "id": 1691,
      "name": "Series 7",
      "overview": "",
      "poster_path": null,
      "season_number": 7,
      "vote_average": 0
    }
  ],
  "spoken_languages": [
    {
      "english_name": "English",
      "iso_639_1": "en",
      "name": "English"
    }
  ],
  "status": "Ended",
  "tagline": "",
  "type": "Scripted",
  "vote_average": 7.326,
  "vote_count": 23
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

series_id · integer · required

The series ID of the tv

Query Parameters

append_to_response · string

comma separated list of endpoints within this namespace, 20 items max

language · string

Defaults to en-US

Response

200 - application/json

Successful

adult · boolean

Indicates whether the content is intended for adult audiences.

backdrop_path · string

The relative path to the backdrop image for the content.

created_by · string

Represents the creator(s) of the show.

episode_run_time · array

Specifies the runtime of each episode in minutes.

first_air_date · string

The date when the show first premiered, typically in the format YYYY-MM-DD.

genres · object[]

A list of genres associated with the content, each represented as an object.

Show child attributes

homepage · string

The URL to the official website of the content.

id · integer

A unique identifier assigned to the content.

in_production · boolean

Indicates whether the show is still in production (true) or has been concluded (false).

language · array

The language(s) in which the content was originally produced, following ISO 639-1 codes.

last_air_date · string

The date of the last aired episode, typically in the format YYYY-MM-DD.

last_episode_to_air · object

Details of the last aired episode.

Show child attributes

name · string

The official name or title of the series.

next_episode_to_air · string

The air date of the upcoming episode, if available, typically in the format YYYY-MM-DD.

networks · object[]

Details of the network(s) that broadcast the series.

Show child attributes

number_of_episodes · integer

The total count of episodes in the series.

number_of_seasons · integer

The total count of seasons in the series.

origin_country · array

The country or countries where the series originated, represented by their respective codes.

original_language · string

The language in which the series was originally produced, represented as a language code.

original_name · string

The original title of the series.

overview · string

A brief description or synopsis of the series.

popularity · number

A numerical representation of the content's popularity, typically based on audience engagement.

poster_path · string

The relative path to the poster image for the content.

production_company · object[]

A list of production companies involved in creating the content.

Show child attributes

production_countries · object[]

A list of countries where the content was produced.

Show child attributes

season · object[]

Represents a collection of seasons in the series.

Show child attributes

spoken_languages · object[]

A list of languages spoken in the content, each represented as an object.

Show child attributes

status · string

The current status of the series.

tagline · string

A tagline or short phrase associated with the content.

title · string

The official or display title of the content.

type · boolean

Represents the type of content.

vote_average · number

The average rating given to the content by users.

vote_count · integer

The total number of votes or ratings received for the content.