Skip to main content
GET
/
search
/
tv
TV Shows
curl --request GET \
  --url https://api.themoviedb.org/3/search/tv \
  --header 'Authorization: Bearer <token>'
{
  "page": 1,
  "results": [
    {
      "adult": false,
      "backdrop_path": "/bsNm9z2TJfe0WO3RedPGWQ8mG1X.jpg",
      "genre_ids": [
        18,
        80
      ],
      "id": 1396,
      "origin_country": [
        "US"
      ],
      "original_language": "en",
      "original_name": "Breaking Bad",
      "overview": "When Walter White, a New Mexico chemistry teacher, is diagnosed with Stage III cancer and given a prognosis of only two years left to live. He becomes filled with a sense of fearlessness and an unrelenting desire to secure his family's financial future at any cost as he enters the dangerous world of drugs and crime.",
      "popularity": 298.884,
      "poster_path": "/ggFHVNu6YYI5L9pCfOacjizRGt.jpg",
      "first_air_date": "2008-01-20",
      "name": "Breaking Bad",
      "vote_average": 8.879,
      "vote_count": 11536
    }
  ],
  "total_pages": 1,
  "total_results": 1
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
query
string
required

Filter or retrieve specific results

​
first_air_date_year
integer

Search only the first air date

​
include_adult
boolean

Defaults to false

​
language
string

Defaults to en-US

​
page
integer

Defaults to 1

​
year
integer

Search the first air date and all episode air dates

Response

200 - application/json

Successful

​
page
integer

Indicates the current page number

​
results
object[]

Contains the list of data or items

​
total_pages
integer

Specifies the total number of pages available

​
total_results
integer

Represents the total number of items or records in a dataset