TV

This endpoint search for TV shows by their original, translated and also known as names.

GET /3/search/tv

Try it

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": "/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[]

Show child attributes

results. adult · boolean

Example:

false

results. backdrop_path · string

Example:

"/e2VJlbpOXt3U51FaHqyI6NZNNVE.jpg"

results. first_air_date · string

Example:

"2000-10-16"

results. genre_ids · number[]

Example:

[16, 18]

results. id · number

Example:

20101

results. name · string

Example:

"Android Kikaider"

results. origin_country · string[]

Example:

["JP"]

results. original_language · string

Example:

"ja"

results. original_name · string

Example:

"人造人間キカイダー THE ANIMATION"

results. overview · string

Example:

"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."

results. popularity · number

Example:

28.58

results. poster_path · string

Example:

"/6kjsZbqHXs9qo1N7q1z8R4PCdpq.jpg"

results. vote_average · number

Example:

6.3

results. vote_count · number

Example:

3

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