Skip to main content
GET
/
3
/
search
/
tv
TV
curl --request GET \
  --url https://api.themoviedb.org/3/search/tv \
  --header 'Authorization: Bearer <token>'
{
  "page": 1,
  "results": [
    {
      "adult": false,
      "backdrop_path": "/e2VJlbpOXt3U51FaHqyI6NZNNVE.jpg",
      "first_air_date": "2000-10-16",
      "genre_ids": [
        16,
        18
      ],
      "id": 20101,
      "name": "Android Kikaider",
      "origin_country": [
        "JP"
      ],
      "original_language": "ja",
      "original_name": "人造人間キカイダー THE ANIMATION",
      "overview": "The genius robotics professor Dr. Komyoji has created Jiro, a humanoid robot. Gifted with a conscience circuit, he has the power to simulate real emotions that help to distinguish between “right and wrong”.\n\nJiro must protect Mitsuko and Masaru from the evil Dr. Gil who wants Jiro to join his army and aid in his goal of world domination.",
      "popularity": 28.58,
      "poster_path": "/6kjsZbqHXs9qo1N7q1z8R4PCdpq.jpg",
      "vote_average": 6.3,
      "vote_count": 3
    }
  ],
  "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
Example:

"animation"

​
first_air_date_year
integer

Search only the first air date. Valid values are- 1000..9999

Example:

2000

​
include_adult
boolean
default:false
​
language
string
default:en-US
​
page
integer
default:1
​
year
integer

Search the first air date and all episode air dates. Valid values are- 1000..9999

Example:

""

Response

200 - application/json

TV

​
page
number
Example:

1

​
results
object[]
Example:
[
  {
    "adult": false,
    "backdrop_path": "/e2VJlbpOXt3U51FaHqyI6NZNNVE.jpg",
    "first_air_date": "2000-10-16",
    "genre_ids": [16, 18],
    "id": 20101,
    "name": "Android Kikaider",
    "origin_country": ["JP"],
    "original_language": "ja",
    "original_name": "人造人間キカイダー THE ANIMATION",
    "overview": "The genius robotics professor Dr. Komyoji has created Jiro, a humanoid robot. Gifted with a conscience circuit, he has the power to simulate real emotions that help to distinguish between “right and wrong”.\n\nJiro must protect Mitsuko and Masaru from the evil Dr. Gil who wants Jiro to join his army and aid in his goal of world domination.",
    "popularity": 28.58,
    "poster_path": "/6kjsZbqHXs9qo1N7q1z8R4PCdpq.jpg",
    "vote_average": 6.3,
    "vote_count": 3
  }
]
​
total_pages
number
Example:

1

​
total_results
number
Example:

1

⌘I