Watchlist Movies

This endpoint get a list of movies added to a users watchlist.

Authorizations

Authorization

string

header

required

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

Path Parameters

account_id

integer

required

This refers to a unique identifier assigned to a user account.

Example:

""

Query Parameters

language

string

Specifies the language in which the response should be returned.

Example:

"en-US"

page

integer

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

Example:

1

session_id

string

A token that represents a logged-in user's session after they have authenticated with their TMDB account.

Example:

""

sort_by

enum<string>

Determines how the results should be sorted. 'created_at.asc' indicates ascending order based on the creation date.

Available options:

created_at.asc,

created_at.desc

Example:

"created_at.asc"

Response

200 - application/json

watchlist movies

page

number

Indicates the current page number of the results being returned.

Example:

1

results

object[]

This represents a collection of movie objects returned by the API that provides information about various films.

Show child attributes

results.adult

boolean

Indicates if the movie is intended for adults (true) or is suitable for general audiences (false).

Example:

false

results.backdrop_path

string

The URL path to the movie's backdrop image (used for background displays).

Example:

"/zqkmTXzjkAgXmEWLRsY4UpTWCeo.jpg"

results.genre_ids

number[]

An array of genre IDs that represent the types of genres the movie falls under.

Example:

[12, 28, 878]

results.id

number

A unique identifier for the movie within the database.

Example:

11

results.original_language

string

A string that specifies the original language in which the movie was produced, typically represented as a two-letter language code (e.g., "en" for English).

Example:

"en"

results.original_title

string

The original title of the movie as it was released in its native language.

Example:

"Star Wars"

results.overview

string

A brief summary of the movie's plot or storyline

Example:

"Princess Leia is captured and held hostage by the evil Imperial forces in their effort to take over the galactic Empire. Venturesome Luke Skywalker and dashing captain Han Solo team together with the loveable robot duo R2-D2 and C-3PO to rescue the beautiful princess and restore peace and justice in the Empire."

results.popularity

number

A numerical value indicating the popularity of the movie based on user ratings and engagement. A higher number suggests greater popularity in the viewing audience.

Example:

96.503

results.poster_path

string

The URL path to the movie's poster image (used for display purposes).

Example:

"/6FfCtAuVAW8XJjZ7eWeLibRLWTw.jpg"

results.release_date

string

The date when the movie was released, represented in the format YYYY-MM-DD, indicating the specific day the movie became available to the public.

Example:

"1977-05-25"

results.title

string

The title of the movie as it appears in releases.

Example:

"Star Wars"

results.video

boolean

A boolean value indicating whether there is an associated video (such as a trailer) available for the movie. true means there is a video, whereas false indicates there is none.

Example:

false

results.vote_average

number

The average rating of the movie based on user votes.

Example:

8.203

results.vote_count

number

An integer representing the total number of votes that the movie has received.

Example:

20650

Example:

[
  {
    "adult": false,
    "backdrop_path": "/zqkmTXzjkAgXmEWLRsY4UpTWCeo.jpg",
    "genre_ids": [12, 28, 878],
    "id": 11,
    "original_language": "en",
    "original_title": "Star Wars",
    "overview": "Princess Leia is captured and held hostage by the evil Imperial forces in their effort to take over the galactic Empire. Venturesome Luke Skywalker and dashing captain Han Solo team together with the loveable robot duo R2-D2 and C-3PO to rescue the beautiful princess and restore peace and justice in the Empire.",
    "popularity": 96.503,
    "poster_path": "/6FfCtAuVAW8XJjZ7eWeLibRLWTw.jpg",
    "release_date": "1977-05-25",
    "title": "Star Wars",
    "video": false,
    "vote_average": 8.203,
    "vote_count": 20650
  }
]

total_pages

number

The total number of pages available in the results.

Example:

1

total_results

number

The total number of results found for the query submitted.

Example:

1