Tv

This endpoint allows you to search for TV shows by their original, translated, and alternative names.

GET /3/search/tv

Tv

cURL

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

200

{
  "page": 1,
  "results": [
    {
      "adult": false,
      "backdrop_path": "/2meX1nMdScFOoV4370rqHWKmXhY.jpg",
      "first_air_date": "2021-09-17",
      "genre_ids": [
        10759,
        9648,
        18
      ],
      "id": 93405,
      "name": "Squid Game",
      "origin_country": [
        "KR"
      ],
      "original_language": "ko",
      "original_name": "오징어 게임",
      "overview": "Hundreds of cash-strapped players accept a strange invitation to compete in children's games. Inside, a tempting prize awaits — with deadly high stakes.",
      "popularity": 1601.261,
      "poster_path": "/dDlEmu3EZ0Pgg93K2SVNLCjCSvE.jpg",
      "vote_average": 7.8,
      "vote_count": 14205
    }
  ],
  "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

This represents the name of the Tv show you want to look for.

Example:

"Squid Game"

first_air_date_year · string

This represents the first air date year of the TV show.

Example:

"2021-09-17"

include_adult · string

This specifies if adult-rated shows should be included.

Example:

"false"

page · string

This represents the page number.

Example:

"1"

year · string

This represents the year the TV show was released.

Response

200 - application/json

TV

page · number

Example:

1

results · object[]

Show child attributes

results. adult · boolean

Example:

false

results. backdrop_path · string

Example:

"/2meX1nMdScFOoV4370rqHWKmXhY.jpg"

results. first_air_date · string

Example:

"2021-09-17"

results. genre_ids · number[]

Example:

[10759, 9648, 18]

results. id · number

Example:

93405

results. name · string

Example:

"Squid Game"

results. origin_country · string[]

Example:

["KR"]

results. original_language · string

Example:

"ko"

results. original_name · string

Example:

"오징어 게임"

results. overview · string

Example:

"Hundreds of cash-strapped players accept a strange invitation to compete in children's games. Inside, a tempting prize awaits — with deadly high stakes."

results. popularity · number

Example:

1601.261

results. poster_path · string

Example:

"/dDlEmu3EZ0Pgg93K2SVNLCjCSvE.jpg"

results. vote_average · number

Example:

7.8

results. vote_count · number

Example:

14205

Example:

[
  {
    "adult": false,
    "backdrop_path": "/2meX1nMdScFOoV4370rqHWKmXhY.jpg",
    "first_air_date": "2021-09-17",
    "genre_ids": [10759, 9648, 18],
    "id": 93405,
    "name": "Squid Game",
    "origin_country": ["KR"],
    "original_language": "ko",
    "original_name": "오징어 게임",
    "overview": "Hundreds of cash-strapped players accept a strange invitation to compete in children's games. Inside, a tempting prize awaits — with deadly high stakes.",
    "popularity": 1601.261,
    "poster_path": "/dDlEmu3EZ0Pgg93K2SVNLCjCSvE.jpg",
    "vote_average": 7.8,
    "vote_count": 14205
  }
]

total_pages · number

Example:

1

total_results · number

Example:

1