Details - API documentation

Details

curl --request GET \
  --url https://api.themoviedb.org/3/list/{list_id} \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.themoviedb.org/3/list/{list_id}', 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/list/{list_id}",
  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/list/{list_id}"

	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/list/{list_id}")

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

{
  "created_by": "SirJosh",
  "description": "This contains the list of all anime, movie or TV shows",
  "favorite_count": 0,
  "id": 8504997,
  "iso_639_1": "en",
  "item_count": 1,
  "items": [
    {
      "adult": false,
      "backdrop_path": "/wgvc3PmjQGtYYDWaeuV867mnFDs.jpg",
      "genre_ids": [
        878,
        28,
        12
      ],
      "id": 18,
      "media_type": "movie",
      "original_language": "fr",
      "original_title": "Le Cinquième Élément",
      "overview": "In 2257, a taxi driver is unintentionally given the task of saving a young girl who is part of the key that will ensure the survival of humanity.",
      "popularity": 69.185,
      "poster_path": "/fPtlCO1yQtnoLHOwKtWz7db6RGU.jpg",
      "release_date": "1997-05-02",
      "title": "The Fifth Element",
      "video": false,
      "vote_average": 7.554,
      "vote_count": 10764
    }
  ],
  "name": "Anime",
  "page": 1,
  "poster_path": null,
  "total_pages": 1,
  "total_results": 1
}

GET

list

{list_id}

Details

curl --request GET \
  --url https://api.themoviedb.org/3/list/{list_id} \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.themoviedb.org/3/list/{list_id}', 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/list/{list_id}",
  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/list/{list_id}"

	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/list/{list_id}")

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

{
  "created_by": "SirJosh",
  "description": "This contains the list of all anime, movie or TV shows",
  "favorite_count": 0,
  "id": 8504997,
  "iso_639_1": "en",
  "item_count": 1,
  "items": [
    {
      "adult": false,
      "backdrop_path": "/wgvc3PmjQGtYYDWaeuV867mnFDs.jpg",
      "genre_ids": [
        878,
        28,
        12
      ],
      "id": 18,
      "media_type": "movie",
      "original_language": "fr",
      "original_title": "Le Cinquième Élément",
      "overview": "In 2257, a taxi driver is unintentionally given the task of saving a young girl who is part of the key that will ensure the survival of humanity.",
      "popularity": 69.185,
      "poster_path": "/fPtlCO1yQtnoLHOwKtWz7db6RGU.jpg",
      "release_date": "1997-05-02",
      "title": "The Fifth Element",
      "video": false,
      "vote_average": 7.554,
      "vote_count": 10764
    }
  ],
  "name": "Anime",
  "page": 1,
  "poster_path": null,
  "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

language

string

Specifies the language in which the response should be returned.

Example:

"en-US"

list_id

number

required

This is the unique identifier of the list been created

Example:

""

page

integer

Indicates which page of results to return. Default is the first page (1).

Example:

1

Response

200 - application/json

details

created_by

string

The name of the user who created the list.

Example:

"SirJosh"

description

string

A textual description of the list.

Example:

"This contains the list of all anime, movie or TV shows"

favorite_count

number

The number of users who have marked the list as a favorite (default is 0).

Example:

0

number

The unique identifier for the list.

Example:

8504997

iso_639_1

string

The ISO 639-1 code for the language of the list.

Example:

"en"

item_count

number

The total number of items in the list.

Example:

1

items

object[]

A collection of items (movies/shows) contained in the list.

Show child attributes

Example:

[
  {
    "adult": false,
    "backdrop_path": "/wgvc3PmjQGtYYDWaeuV867mnFDs.jpg",
    "genre_ids": [878, 28, 12],
    "id": 18,
    "media_type": "movie",
    "original_language": "fr",
    "original_title": "Le Cinquième Élément",
    "overview": "In 2257, a taxi driver is unintentionally given the task of saving a young girl who is part of the key that will ensure the survival of humanity.",
    "popularity": 69.185,
    "poster_path": "/fPtlCO1yQtnoLHOwKtWz7db6RGU.jpg",
    "release_date": "1997-05-02",
    "title": "The Fifth Element",
    "video": false,
    "vote_average": 7.554,
    "vote_count": 10764
  }
]

name

string

The name of the list.

Example:

"Anime"

page

number

The current page number of the results being displayed.

Example:

1

poster_path

any | null

The path of the poster image associated with the list. When poster_path is null, it means that the item does not have an associated poster image in the database.

Example:

null

total_pages

number

The total number of pages available for the query results.

Example:

1

total_results

number

The total number of results found for the query.

Example:

1