ACCOUNT
- Endpoints
AUTHENTICATION
- Endpoints
CERTIFICATIONS
- Endpoints
CHANGES
- Endpoints
COLLECTIONS
- Endpoints
COMPANIES
- Endpoints
CONFIGURATION
- Endpoints
CREDITS
FIND
GENRES
GUEST-SESSIONS
KEYWORDS
MOVIES
PEOPLE
PEOPLE-LISTS
REVIEWS
TV-EPISODE-GROUPS
TV-EPISODES
TV-SEASONS
TV-SERIES
TV-SERIES-LISTS
WATCH-PROVIDERS
SEARCH
TV Shows
This endpoint searches for TV shows by their original, translated and also known as names.
GET
/
3
/
search
/
tv
Copy
curl --request GET \
--url https://api.themoviedb.org/3/search/tv \
--header 'Authorization: Bearer <token>'
Copy
{
"page": 1,
"results": [
{
"adult": false,
"backdrop_path": "/zZqpAXxVSBtxV9qPBcscfXBcL2w.jpg",
"first_air_date": "2011-04-17",
"genre_ids": [
10765,
18,
10759
],
"id": 1399,
"name": "Game of Thrones",
"origin_country": [
"US"
],
"original_language": "en",
"original_name": "Game of Thrones",
"overview": "Seven noble families fight for control of the mythical land of Westeros. Friction between the houses leads to full-scale war. All while a very ancient evil awakens in the farthest north. Amidst the war, a neglected military order of misfits, the Night's Watch, is all that stands between the realms of men and icy horrors beyond.",
"popularity": 892.36,
"poster_path": "/1XS1oqL89opfnbLl8WnZY1O1uJx.jpg",
"vote_average": 8.456,
"vote_count": 24408
},
{
"adult": false,
"backdrop_path": "/q0EfVHIIxCyCqUKNEvtGqx4iZig.jpg",
"first_air_date": "2021-04-05",
"genre_ids": [
10767
],
"id": 206584,
"name": "The Game of Thrones Reunion Hosted by Conan O'Brien",
"origin_country": [
"US"
],
"original_language": "en",
"original_name": "The Game of Thrones Reunion Hosted by Conan O'Brien",
"overview": "A two-part reunion show with cast members from the final season including Kit Harington, Emilia Clarke, Sophie Turner and more, as well as previously departed fan-favorites like Sean Bean, Jason Momoa, Mark Addy and others.",
"popularity": 6.041,
"poster_path": "/xwq2TALKkuCujBnUTpr57wDO61y.jpg",
"vote_average": 8.2,
"vote_count": 8
},
{
"adult": false,
"backdrop_path": "/etj8E2o0Bud0HkONVQPjyCkIvpv.jpg",
"first_air_date": "2022-08-21",
"genre_ids": [
10765,
18,
10759
],
"id": 94997,
"name": "House of the Dragon",
"origin_country": [
"US"
],
"original_language": "en",
"original_name": "House of the Dragon",
"overview": "The Targaryen dynasty is at the absolute apex of its power, with more than 15 dragons under their yoke. Most empires crumble from such heights. In the case of the Targaryens, their slow fall begins when King Viserys breaks with a century of tradition by naming his daughter Rhaenyra heir to the Iron Throne. But when Viserys later fathers a son, the court is shocked when Rhaenyra retains her status as his heir, and seeds of division sow friction across the realm.",
"popularity": 341.675,
"poster_path": "/t9XkeE7HzOsdQcDDDapDYh8Rrmt.jpg",
"vote_average": 8.4,
"vote_count": 5099
},
{
"adult": false,
"backdrop_path": "/oGXuxNzrZ9QNuYYd7N4Zb9V6YKl.jpg",
"first_air_date": "",
"genre_ids": [
18,
10765
],
"id": 224372,
"name": "A Knight of the Seven Kingdoms: The Hedge Knight",
"origin_country": [
"US"
],
"original_language": "en",
"original_name": "A Knight of the Seven Kingdoms: The Hedge Knight",
"overview": "Set in an age when the Targaryen line still holds the Iron Throne and the memory of the last dragon has not yet passed from living memory, great destinies, powerful foes and dangerous exploits all await these improbable and incomparable friends.",
"popularity": 15.961,
"poster_path": "/7Pb4gk51oUKWarOhvaSgf5RekIj.jpg",
"vote_average": 0,
"vote_count": 0
}
],
"total_pages": 1,
"total_results": 4
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Query Parameters
Example:
"game%20of%20thrones"
Example:
"false"
Example:
"en-US"
Example:
"1"
Response
200 - application/json
TV Shows Example
The response is of type object
.
Copy
curl --request GET \
--url https://api.themoviedb.org/3/search/tv \
--header 'Authorization: Bearer <token>'
Copy
{
"page": 1,
"results": [
{
"adult": false,
"backdrop_path": "/zZqpAXxVSBtxV9qPBcscfXBcL2w.jpg",
"first_air_date": "2011-04-17",
"genre_ids": [
10765,
18,
10759
],
"id": 1399,
"name": "Game of Thrones",
"origin_country": [
"US"
],
"original_language": "en",
"original_name": "Game of Thrones",
"overview": "Seven noble families fight for control of the mythical land of Westeros. Friction between the houses leads to full-scale war. All while a very ancient evil awakens in the farthest north. Amidst the war, a neglected military order of misfits, the Night's Watch, is all that stands between the realms of men and icy horrors beyond.",
"popularity": 892.36,
"poster_path": "/1XS1oqL89opfnbLl8WnZY1O1uJx.jpg",
"vote_average": 8.456,
"vote_count": 24408
},
{
"adult": false,
"backdrop_path": "/q0EfVHIIxCyCqUKNEvtGqx4iZig.jpg",
"first_air_date": "2021-04-05",
"genre_ids": [
10767
],
"id": 206584,
"name": "The Game of Thrones Reunion Hosted by Conan O'Brien",
"origin_country": [
"US"
],
"original_language": "en",
"original_name": "The Game of Thrones Reunion Hosted by Conan O'Brien",
"overview": "A two-part reunion show with cast members from the final season including Kit Harington, Emilia Clarke, Sophie Turner and more, as well as previously departed fan-favorites like Sean Bean, Jason Momoa, Mark Addy and others.",
"popularity": 6.041,
"poster_path": "/xwq2TALKkuCujBnUTpr57wDO61y.jpg",
"vote_average": 8.2,
"vote_count": 8
},
{
"adult": false,
"backdrop_path": "/etj8E2o0Bud0HkONVQPjyCkIvpv.jpg",
"first_air_date": "2022-08-21",
"genre_ids": [
10765,
18,
10759
],
"id": 94997,
"name": "House of the Dragon",
"origin_country": [
"US"
],
"original_language": "en",
"original_name": "House of the Dragon",
"overview": "The Targaryen dynasty is at the absolute apex of its power, with more than 15 dragons under their yoke. Most empires crumble from such heights. In the case of the Targaryens, their slow fall begins when King Viserys breaks with a century of tradition by naming his daughter Rhaenyra heir to the Iron Throne. But when Viserys later fathers a son, the court is shocked when Rhaenyra retains her status as his heir, and seeds of division sow friction across the realm.",
"popularity": 341.675,
"poster_path": "/t9XkeE7HzOsdQcDDDapDYh8Rrmt.jpg",
"vote_average": 8.4,
"vote_count": 5099
},
{
"adult": false,
"backdrop_path": "/oGXuxNzrZ9QNuYYd7N4Zb9V6YKl.jpg",
"first_air_date": "",
"genre_ids": [
18,
10765
],
"id": 224372,
"name": "A Knight of the Seven Kingdoms: The Hedge Knight",
"origin_country": [
"US"
],
"original_language": "en",
"original_name": "A Knight of the Seven Kingdoms: The Hedge Knight",
"overview": "Set in an age when the Targaryen line still holds the Iron Throne and the memory of the last dragon has not yet passed from living memory, great destinies, powerful foes and dangerous exploits all await these improbable and incomparable friends.",
"popularity": 15.961,
"poster_path": "/7Pb4gk51oUKWarOhvaSgf5RekIj.jpg",
"vote_average": 0,
"vote_count": 0
}
],
"total_pages": 1,
"total_results": 4
}
Assistant
Responses are generated using AI and may contain mistakes.