Videos
This endpoint the videos of a TV season.
GET
/
3
/
tv
/
{series_id}
/
season
/
{season_number}
/
videos
curl --request GET \
--url https://api.themoviedb.org/3/tv/{series_id}/season/{season_number}/videos \
--header 'Authorization: Bearer <token>'
{
"id": 131977,
"results": [
{
"id": "676276a1a0cc3de647ffdfbf",
"iso_3166_1": "US",
"iso_639_1": "en",
"key": "TpJLHswu8Do",
"name": "The Cast of Squid Game Recaps the Story of Season 1 [ENG SUB]",
"official": true,
"published_at": "2024-12-18T00:00:00.000Z",
"site": "YouTube",
"size": 1080,
"type": "Recap"
},
{
"id": "674734b9026682b92eb076fe",
"iso_3166_1": "US",
"iso_639_1": "en",
"key": "I2tIKgzK_vU",
"name": "Season 1 Full Story Recap",
"official": true,
"published_at": "2024-11-27T14:00:00.000Z",
"site": "YouTube",
"size": 1080,
"type": "Recap"
},
{
"id": "6704c09e5c00a2d44ec00418",
"iso_3166_1": "US",
"iso_639_1": "en",
"key": "OT9g2yEUVGc",
"name": "Get Back In The Game [ENG SUB]",
"official": true,
"published_at": "2024-10-07T22:00:00.000Z",
"site": "YouTube",
"size": 1080,
"type": "Trailer"
},
{
"id": "66ff93cbf878adfed085155a",
"iso_3166_1": "US",
"iso_639_1": "en",
"key": "Ctu1BN-8b7E",
"name": "Looking Back at Squid Game Season 1 [Subtitled]",
"official": true,
"published_at": "2024-10-03T21:00:00.000Z",
"site": "YouTube",
"size": 1080,
"type": "Featurette"
},
{
"id": "632f1c9b7ecd280083053e48",
"iso_3166_1": "US",
"iso_639_1": "en",
"key": "Ls8ilKMQHxQ",
"name": "Season 1 Unreleased Clip",
"official": true,
"published_at": "2022-09-24T02:32:01.000Z",
"site": "YouTube",
"size": 1080,
"type": "Clip"
},
{
"id": "66ba9db78a39617c71decf86",
"iso_3166_1": "US",
"iso_639_1": "en",
"key": "8vac9r4WPQI",
"name": "Behind the Scene [ENG SUB]",
"official": true,
"published_at": "2021-09-24T02:00:00.000Z",
"site": "YouTube",
"size": 1080,
"type": "Behind the Scenes"
}
]
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
a uniques identifier for a tv serie
Example:
1
Query Parameters
filter the list results by language, supports more than one value by using a comma
Response
200 - application/json
Videos
The response is of type object
.
curl --request GET \
--url https://api.themoviedb.org/3/tv/{series_id}/season/{season_number}/videos \
--header 'Authorization: Bearer <token>'
{
"id": 131977,
"results": [
{
"id": "676276a1a0cc3de647ffdfbf",
"iso_3166_1": "US",
"iso_639_1": "en",
"key": "TpJLHswu8Do",
"name": "The Cast of Squid Game Recaps the Story of Season 1 [ENG SUB]",
"official": true,
"published_at": "2024-12-18T00:00:00.000Z",
"site": "YouTube",
"size": 1080,
"type": "Recap"
},
{
"id": "674734b9026682b92eb076fe",
"iso_3166_1": "US",
"iso_639_1": "en",
"key": "I2tIKgzK_vU",
"name": "Season 1 Full Story Recap",
"official": true,
"published_at": "2024-11-27T14:00:00.000Z",
"site": "YouTube",
"size": 1080,
"type": "Recap"
},
{
"id": "6704c09e5c00a2d44ec00418",
"iso_3166_1": "US",
"iso_639_1": "en",
"key": "OT9g2yEUVGc",
"name": "Get Back In The Game [ENG SUB]",
"official": true,
"published_at": "2024-10-07T22:00:00.000Z",
"site": "YouTube",
"size": 1080,
"type": "Trailer"
},
{
"id": "66ff93cbf878adfed085155a",
"iso_3166_1": "US",
"iso_639_1": "en",
"key": "Ctu1BN-8b7E",
"name": "Looking Back at Squid Game Season 1 [Subtitled]",
"official": true,
"published_at": "2024-10-03T21:00:00.000Z",
"site": "YouTube",
"size": 1080,
"type": "Featurette"
},
{
"id": "632f1c9b7ecd280083053e48",
"iso_3166_1": "US",
"iso_639_1": "en",
"key": "Ls8ilKMQHxQ",
"name": "Season 1 Unreleased Clip",
"official": true,
"published_at": "2022-09-24T02:32:01.000Z",
"site": "YouTube",
"size": 1080,
"type": "Clip"
},
{
"id": "66ba9db78a39617c71decf86",
"iso_3166_1": "US",
"iso_639_1": "en",
"key": "8vac9r4WPQI",
"name": "Behind the Scene [ENG SUB]",
"official": true,
"published_at": "2021-09-24T02:00:00.000Z",
"site": "YouTube",
"size": 1080,
"type": "Behind the Scenes"
}
]
}