Details

This endpoint query the details of a TV season.

GET /tv/{series_id}/season/{season_number}

Details

cURL

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

200

{
  "_id": "5253853619c29579402062d8",
  "air_date": "1975-11-05",
  "episodes": [
    {
      "air_date": "1975-11-05",
      "episode_number": 1,
      "episode_type": "standard",
      "id": 31095,
      "name": "Moving in with Min",
      "overview": "With it clear Else isn't returning, Alf considers sale of the house and moving in with Min and Reed next door.",
      "production_code": "",
      "runtime": 30,
      "season_number": 7,
      "show_id": 550,
      "still_path": null,
      "vote_average": 0,
      "vote_count": 0,
      "crew": [
        {
          "department": "Directing",
          "job": "Director",
          "credit_id": "5253853d19c29579402067a6",
          "adult": false,
          "gender": 0,
          "id": 1218302,
          "known_for_department": "Production",
          "name": "Dennis Main Wilson",
          "original_name": "Dennis Main Wilson",
          "popularity": 1.445,
          "profile_path": null
        }
      ],
      "guest_stars": [
        {
          "character": "",
          "credit_id": "5253853b19c2957940206734",
          "order": 500,
          "adult": false,
          "gender": 2,
          "id": 30119,
          "known_for_department": "Acting",
          "name": "Alfie Bass",
          "original_name": "Alfie Bass",
          "popularity": 12.177,
          "profile_path": "/1LnDvjwwtiQTrcaHGPDLsF9f3rq.jpg"
        },
        {
          "character": "",
          "credit_id": "5253853b19c2957940206776",
          "order": 502,
          "adult": false,
          "gender": 1,
          "id": 12658,
          "known_for_department": "Acting",
          "name": "Patricia Hayes",
          "original_name": "Patricia Hayes",
          "popularity": 14.271,
          "profile_path": "/6XFwNMFX81TJOvY5k5V0rUANQL.jpg"
        }
      ]
    },
    {
      "air_date": "1975-11-12",
      "episode_number": 2,
      "episode_type": "standard",
      "id": 31096,
      "name": "Min the Housekeeper",
      "overview": "Min goes on strike as housekeeper.",
      "production_code": "",
      "runtime": 30,
      "season_number": 7,
      "show_id": 550,
      "still_path": null,
      "vote_average": 0,
      "vote_count": 0,
      "crew": [
        {
          "department": "Directing",
          "job": "Director",
          "credit_id": "5253853d19c29579402067a6",
          "adult": false,
          "gender": 0,
          "id": 1218302,
          "known_for_department": "Production",
          "name": "Dennis Main Wilson",
          "original_name": "Dennis Main Wilson",
          "popularity": 1.445,
          "profile_path": null
        }
      ],
      "guest_stars": [
        {
          "character": "",
          "credit_id": "5253853b19c2957940206734",
          "order": 500,
          "adult": false,
          "gender": 2,
          "id": 30119,
          "known_for_department": "Acting",
          "name": "Alfie Bass",
          "original_name": "Alfie Bass",
          "popularity": 12.177,
          "profile_path": "/1LnDvjwwtiQTrcaHGPDLsF9f3rq.jpg"
        },
        {
          "character": "",
          "credit_id": "5253853b19c2957940206776",
          "order": 502,
          "adult": false,
          "gender": 1,
          "id": 12658,
          "known_for_department": "Acting",
          "name": "Patricia Hayes",
          "original_name": "Patricia Hayes",
          "popularity": 14.271,
          "profile_path": "/6XFwNMFX81TJOvY5k5V0rUANQL.jpg"
        }
      ]
    },
    {
      "air_date": "1975-11-19",
      "episode_number": 3,
      "episode_type": "standard",
      "id": 31097,
      "name": "Drunk in Charge of a Bicycle",
      "overview": "Alf and Bert go out for the day and Alf gets drunk and arrested for riding a bicycle intoxicated",
      "production_code": "",
      "runtime": 30,
      "season_number": 7,
      "show_id": 550,
      "still_path": null,
      "vote_average": 0,
      "vote_count": 0,
      "crew": [
        {
          "department": "Directing",
          "job": "Director",
          "credit_id": "5253853d19c29579402067a6",
          "adult": false,
          "gender": 0,
          "id": 1218302,
          "known_for_department": "Production",
          "name": "Dennis Main Wilson",
          "original_name": "Dennis Main Wilson",
          "popularity": 1.445,
          "profile_path": null
        }
      ],
      "guest_stars": []
    },
    {
      "air_date": "1975-11-26",
      "episode_number": 4,
      "episode_type": "standard",
      "id": 31098,
      "name": "The Window",
      "overview": "While cleaning the windows, Alf gets stuck on the ledge.",
      "production_code": "",
      "runtime": 30,
      "season_number": 7,
      "show_id": 550,
      "still_path": null,
      "vote_average": 0,
      "vote_count": 0,
      "crew": [
        {
          "department": "Directing",
          "job": "Director",
          "credit_id": "5253853d19c29579402067a6",
          "adult": false,
          "gender": 0,
          "id": 1218302,
          "known_for_department": "Production",
          "name": "Dennis Main Wilson",
          "original_name": "Dennis Main Wilson",
          "popularity": 1.445,
          "profile_path": null
        }
      ],
      "guest_stars": [
        {
          "character": "",
          "credit_id": "5253853819c2957940206458",
          "order": 512,
          "adult": false,
          "gender": 1,
          "id": 3478,
          "known_for_department": "Acting",
          "name": "Pat Coombs",
          "original_name": "Pat Coombs",
          "popularity": 10.502,
          "profile_path": "/RpsQu7OP71FNGVKTMJtQTbSryc.jpg"
        }
      ]
    },
    {
      "air_date": "1975-12-03",
      "episode_number": 5,
      "episode_type": "standard",
      "id": 31099,
      "name": "A Hole in One",
      "overview": "Alf and Bert head off to go golfing",
      "production_code": "",
      "runtime": 30,
      "season_number": 7,
      "show_id": 550,
      "still_path": null,
      "vote_average": 0,
      "vote_count": 0,
      "crew": [
        {
          "department": "Directing",
          "job": "Director",
          "credit_id": "5253853d19c29579402067a6",
          "adult": false,
          "gender": 0,
          "id": 1218302,
          "known_for_department": "Production",
          "name": "Dennis Main Wilson",
          "original_name": "Dennis Main Wilson",
          "popularity": 1.445,
          "profile_path": null
        }
      ],
      "guest_stars": []
    },
    {
      "air_date": "1975-12-17",
      "episode_number": 6,
      "episode_type": "finale",
      "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",
      "production_code": "",
      "runtime": 30,
      "season_number": 7,
      "show_id": 550,
      "still_path": null,
      "vote_average": 0,
      "vote_count": 0,
      "crew": [
        {
          "department": "Directing",
          "job": "Director",
          "credit_id": "5253853d19c29579402067a6",
          "adult": false,
          "gender": 0,
          "id": 1218302,
          "known_for_department": "Production",
          "name": "Dennis Main Wilson",
          "original_name": "Dennis Main Wilson",
          "popularity": 1.445,
          "profile_path": null
        }
      ],
      "guest_stars": [
        {
          "character": "",
          "credit_id": "5253853819c2957940206458",
          "order": 512,
          "adult": false,
          "gender": 1,
          "id": 3478,
          "known_for_department": "Acting",
          "name": "Pat Coombs",
          "original_name": "Pat Coombs",
          "popularity": 10.502,
          "profile_path": "/RpsQu7OP71FNGVKTMJtQTbSryc.jpg"
        },
        {
          "character": "",
          "credit_id": "6224aae3680be80044ff2797",
          "order": 513,
          "adult": false,
          "gender": 1,
          "id": 40949,
          "known_for_department": "Acting",
          "name": "Joan Sims",
          "original_name": "Joan Sims",
          "popularity": 15.869,
          "profile_path": "/zlqfbnRk85lAqt5ouKdA0JiQZRG.jpg"
        },
        {
          "character": "",
          "credit_id": "6224b1477c6de3001b8a31b9",
          "order": 514,
          "adult": false,
          "gender": 2,
          "id": 575818,
          "known_for_department": "Acting",
          "name": "Hugh Lloyd",
          "original_name": "Hugh Lloyd",
          "popularity": 8.722,
          "profile_path": "/1kUCSbU7802Waqb6a2pI2p2cZwu.jpg"
        }
      ]
    }
  ],
  "name": "Series 7",
  "overview": "",
  "id": 1691,
  "poster_path": null,
  "season_number": 7,
  "vote_average": 0
}

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

season_number · integer · required

The season number of the tv series

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

_id · string

Unique identifier for the season.

air_date · string

The date when the season first aired. YYYY-MM-DD.

episodes · object[]

List of episodes in the season.

Show child attributes

crew · object[]

List of crew members involved in the season’s production.

Show child attributes

guest_stars · object[]

List of guest actors who appeared in one or more episodes.

Show child attributes

name · string

The title of the season.

overview · string

A brief summary or description of the season’s plot.

id · integer

A unique numerical identifier for the season.

poster_path · string

The file path to the season’s poster image.

season_number · integer

The season’s number within the series.

vote_average · number

The average user rating for the season.