TV Shows

TV Shows

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

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.themoviedb.org/3/search/tv', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.themoviedb.org/3/search/tv",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.themoviedb.org/3/search/tv"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.themoviedb.org/3/search/tv")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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
}

GET

TV Shows

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

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.themoviedb.org/3/search/tv', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.themoviedb.org/3/search/tv",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.themoviedb.org/3/search/tv"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.themoviedb.org/3/search/tv")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

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

Authorization

string

header

required

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

Query Parameters

query

string

Example:

"game%20of%20thrones"

include_adult

string

Example:

"false"

language

string

Example:

"en-US"

page

string

Example:

"1"

Response

200 - application/json

TV Shows Example

page

number

Example:

1

results

object[]

Show child attributes

Example:

[
  {
    "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

number

Example:

1

total_results

number

Example:

4

ACCOUNT

AUTHENTICATION

CERTIFICATIONS

CHANGES

COLLECTIONS

COMPANIES

CONFIGURATION

CREDITS

DISCOVER

FIND

GENRES

GUEST-SESSIONS

KEYWORDS

LISTS

MOVIE-LIST

MOVIES

NETWORKS

PEOPLE

PEOPLE-LISTS

REVIEWS

SEARCH

TRENDING

TV-EPISODE-GROUPS

TV-EPISODES

TV-SEASONS

TV-SERIES

TV-SERIES-LISTS

WATCH-PROVIDERS

Authorizations

Query Parameters

Response