Favourite movies

This endpoint get a users list of favourite movies.

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

favourite movies

page

number

The current page number in the paginated results.

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:

"/se5Hxz7PArQZOG3Nx2bpfOhLhtV.jpg"

results.genre_ids

number[]

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

Example:

[28, 12, 16, 10751]

results.id

number

A unique identifier for the movie.

Example:

9806

results.original_language

string

The original language in which the movie was produced.

Example:

"en"

results.original_title

string

The original title of the movie as it was released

Example:

"The Incredibles"

results.overview

string

A brief summary of the movie's plot.

Example:

"Bob Parr has given up his superhero days to log in time as an insurance adjuster and raise his three children with his formerly heroic wife in suburbia. But when he receives a mysterious assignment, it's time to get back into costume."

results.popularity

number

A numerical value indicating the popularity of the movie, often based on user interactions and ratings.

Example:

71.477

results.poster_path

string

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

Example:

"/2LqaLgk4Z226KkgPJuiOQ58wvrm.jpg"

results.release_date

string

The release date of the movie in the format YYYY-MM-DD.

Example:

"2004-10-27"

results.title

string

The title of the movie as displayed to the audience.

Example:

"The Incredibles"

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:

7.702

results.vote_count

number

The total number of votes cast for the movie.

Example:

16162

Example:

[
  {
    "adult": false,
    "backdrop_path": "/se5Hxz7PArQZOG3Nx2bpfOhLhtV.jpg",
    "genre_ids": [28, 12, 16, 10751],
    "id": 9806,
    "original_language": "en",
    "original_title": "The Incredibles",
    "overview": "Bob Parr has given up his superhero days to log in time as an insurance adjuster and raise his three children with his formerly heroic wife in suburbia. But when he receives a mysterious assignment, it's time to get back into costume.",
    "popularity": 71.477,
    "poster_path": "/2LqaLgk4Z226KkgPJuiOQ58wvrm.jpg",
    "release_date": "2004-10-27",
    "title": "The Incredibles",
    "video": false,
    "vote_average": 7.702,
    "vote_count": 16162
  },
  {
    "adult": false,
    "backdrop_path": "/8eRscFbRYl681zDfkjv1jjW1KAA.jpg",
    "genre_ids": [878, 28, 12],
    "id": 1452,
    "original_language": "en",
    "original_title": "Superman Returns",
    "overview": "Superman returns to discover his 5-year absence has allowed Lex Luthor to walk free, and that those he was closest to felt abandoned and have moved on. Luthor plots his ultimate revenge that could see millions killed and change the face of the planet forever, as well as ridding himself of the Man of Steel.",
    "popularity": 23.183,
    "poster_path": "/385XwTQZDpRX2d3kxtnpiLrjBXw.jpg",
    "release_date": "2006-06-28",
    "title": "Superman Returns",
    "video": false,
    "vote_average": 5.723,
    "vote_count": 3716
  },
  {
    "adult": false,
    "backdrop_path": "/xh0ZRdnL4pSqfW73HBf97xiNEFP.jpg",
    "genre_ids": [14, 28],
    "id": 8960,
    "original_language": "en",
    "original_title": "Hancock",
    "overview": "Hancock is a down-and-out superhero who's forced to employ a PR expert to help repair his image when the public grows weary of all the damage he's inflicted during his lifesaving heroics. The agent's idea of imprisoning the antihero to make the world miss him proves successful, but will Hancock stick to his new sense of purpose or slip back into old habits?",
    "popularity": 53.556,
    "poster_path": "/7DyuV2G0hLEqHeueDfOqhZ2DVut.jpg",
    "release_date": "2008-07-01",
    "title": "Hancock",
    "video": false,
    "vote_average": 6.343,
    "vote_count": 8691
  },
  {
    "adult": false,
    "backdrop_path": "/2Gq4teAIkVVv0kc6JsfU66C3VOJ.jpg",
    "genre_ids": [53, 18, 9648],
    "id": 9741,
    "original_language": "en",
    "original_title": "Unbreakable",
    "overview": "An ordinary man makes an extraordinary discovery when a train accident leaves his fellow passengers dead — and him unscathed. The answer to this mystery could lie with the mysterious Elijah Price, a man who suffers from a disease that renders his bones as fragile as glass.",
    "popularity": 24.491,
    "poster_path": "/mLuehrGLiK5zFCyRmDDOH6gbfPf.jpg",
    "release_date": "2000-11-22",
    "title": "Unbreakable",
    "video": false,
    "vote_average": 7.134,
    "vote_count": 8357
  },
  {
    "adult": false,
    "backdrop_path": "/l4QHerTSbMI7qgvasqxP36pqjN6.jpg",
    "genre_ids": [28, 878],
    "id": 603,
    "original_language": "en",
    "original_title": "The Matrix",
    "overview": "Set in the 22nd century, The Matrix tells the story of a computer hacker who joins a group of underground insurgents fighting the vast and powerful computers who now rule the earth.",
    "popularity": 79.309,
    "poster_path": "/f89U3ADr1oiB1s9GkdPOEpXUk5H.jpg",
    "release_date": "1999-03-30",
    "title": "The Matrix",
    "video": false,
    "vote_average": 8.2,
    "vote_count": 23104
  },
  {
    "adult": false,
    "backdrop_path": "/zb6fM1CX41D9rF9hdgclu0peUmy.jpg",
    "genre_ids": [18, 36, 10752],
    "id": 424,
    "original_language": "en",
    "original_title": "Schindler's List",
    "overview": "The true story of how businessman Oskar Schindler saved over a thousand Jewish lives from the Nazis while they worked as slaves in his factory during World War II.",
    "popularity": 51.98,
    "poster_path": "/sF1U4EUQS8YHUYjNl3pMGNIQyr0.jpg",
    "release_date": "1993-12-15",
    "title": "Schindler's List",
    "video": false,
    "vote_average": 8.569,
    "vote_count": 13997
  },
  {
    "adult": false,
    "backdrop_path": "/6ms6RdNcQUAnjBY26aM85xC2wV0.jpg",
    "genre_ids": [28, 53, 878],
    "id": 7191,
    "original_language": "en",
    "original_title": "Cloverfield",
    "overview": "Five young New Yorkers throw their friend a going-away party the night that a monster the size of a skyscraper descends upon the city. Told from the point of view of their video camera, the film is a document of their attempt to survive the most surreal, horrifying event of their lives.",
    "popularity": 31.474,
    "poster_path": "/qIegUGJqyMMCRjkKV1s7A9MqdJ8.jpg",
    "release_date": "2008-01-15",
    "title": "Cloverfield",
    "video": false,
    "vote_average": 6.664,
    "vote_count": 6326
  },
  {
    "adult": false,
    "backdrop_path": "/wh4ze6klUbeichAj603OKZwY1W5.jpg",
    "genre_ids": [28, 53, 878],
    "id": 218,
    "original_language": "en",
    "original_title": "The Terminator",
    "overview": "In the post-apocalyptic future, reigning tyrannical supercomputers teleport a cyborg assassin known as the \"Terminator\" back to 1984 to kill Sarah Connor, whose unborn son is destined to lead insurgents against 21st century mechanical hegemony. Meanwhile, the human-resistance movement dispatches a lone warrior to safeguard Sarah. Can he stop the virtually indestructible killing machine?",
    "popularity": 45.608,
    "poster_path": "/kdYu7YJJP0uuGEuhUX5toqvBSog.jpg",
    "release_date": "1984-10-26",
    "title": "The Terminator",
    "video": false,
    "vote_average": 7.64,
    "vote_count": 11399
  },
  {
    "adult": false,
    "backdrop_path": "/P4bGyJQF0shAcRku3I2perNUQR.jpg",
    "genre_ids": [28, 80],
    "id": 23483,
    "original_language": "en",
    "original_title": "Kick-Ass",
    "overview": "Dave Lizewski is an unnoticed high school student and comic book fan who one day decides to become a super-hero, even though he has no powers, training or meaningful reason to do so.",
    "popularity": 46.304,
    "poster_path": "/8citjdBmjddZjlPsAHEyCKwGVvD.jpg",
    "release_date": "2010-03-22",
    "title": "Kick-Ass",
    "video": false,
    "vote_average": 7.118,
    "vote_count": 10732
  },
  {
    "adult": false,
    "backdrop_path": "/jMBpJFRtrtIXymer93XLavPwI3P.jpg",
    "genre_ids": [28, 53, 878],
    "id": 679,
    "original_language": "en",
    "original_title": "Aliens",
    "overview": "When Ripley's lifepod is found by a salvage crew over 50 years later, she finds that terra-formers are on the very planet they found the alien species. When the company sends a family of colonists out to investigate her story—all contact is lost with the planet and colonists. They enlist Ripley and the colonial marines to return and search for answers.",
    "popularity": 45.005,
    "poster_path": "/r1x5JGpyqZU8PYhbs4UcrO1Xb6x.jpg",
    "release_date": "1986-07-18",
    "title": "Aliens",
    "video": false,
    "vote_average": 7.92,
    "vote_count": 8395
  },
  {
    "adult": false,
    "backdrop_path": "/4ywKTlsIllvQYRiZJPwYACJIHY8.jpg",
    "genre_ids": [18],
    "id": 489,
    "original_language": "en",
    "original_title": "Good Will Hunting",
    "overview": "Will Hunting has a genius-level IQ but chooses to work as a janitor at MIT. When he solves a difficult graduate-level math problem, his talents are discovered by Professor Gerald Lambeau, who decides to help the misguided youth reach his potential. When Will is arrested for attacking a police officer, Professor Lambeau makes a deal to get leniency for him if he will get treatment from therapist Sean Maguire.",
    "popularity": 44.795,
    "poster_path": "/bABCBKYBK7A5G1x0FzoeoNfuj2.jpg",
    "release_date": "1997-12-05",
    "title": "Good Will Hunting",
    "video": false,
    "vote_average": 8.146,
    "vote_count": 10649
  },
  {
    "adult": false,
    "backdrop_path": "/vVBcIN68kFq681b4lObiNJhEVro.jpg",
    "genre_ids": [18, 10749],
    "id": 453,
    "original_language": "en",
    "original_title": "A Beautiful Mind",
    "overview": "John Nash is a brilliant but asocial mathematician fighting schizophrenia. After he accepts secret work in cryptography, his life takes a turn for the nightmarish.",
    "popularity": 27.447,
    "poster_path": "/zwzWCmH72OSC9NA0ipoqw5Zjya8.jpg",
    "release_date": "2001-12-11",
    "title": "A Beautiful Mind",
    "video": false,
    "vote_average": 7.9,
    "vote_count": 9201
  },
  {
    "adult": false,
    "backdrop_path": "/hh28CTWLdxTXA5yJgefZ6gUnFDo.jpg",
    "genre_ids": [80, 9648, 53],
    "id": 807,
    "original_language": "en",
    "original_title": "Se7en",
    "overview": "Two homicide detectives are on a desperate hunt for a serial killer whose crimes are based on the \"seven deadly sins\" in this dark and haunting film that takes viewers from the tortured remains of one victim to the next. The seasoned Det. Sommerset researches each sin in an effort to get inside the killer's mind, while his novice partner, Mills, scoffs at his efforts to unravel the case.",
    "popularity": 42.809,
    "poster_path": "/6yoghtyTpznpBik8EngEmJskVUO.jpg",
    "release_date": "1995-09-22",
    "title": "Se7en",
    "video": false,
    "vote_average": 8.366,
    "vote_count": 18674
  },
  {
    "adult": false,
    "backdrop_path": "/qq4H9JfBKQ5DarMLI6lhUQjn9D7.jpg",
    "genre_ids": [28, 53, 878, 9648],
    "id": 180,
    "original_language": "en",
    "original_title": "Minority Report",
    "overview": "John Anderton is a top 'Precrime' cop in the late-21st century, when technology can predict crimes before they're committed. But Anderton becomes the quarry when another investigator targets him for a murder charge.",
    "popularity": 25.998,
    "poster_path": "/ccqpHq5tk5W4ymbSbuoy4uYOxFI.jpg",
    "release_date": "2002-06-20",
    "title": "Minority Report",
    "video": false,
    "vote_average": 7.333,
    "vote_count": 7725
  },
  {
    "adult": false,
    "backdrop_path": "/9LSsSPbP715XT9B7acIZzantPyX.jpg",
    "genre_ids": [18],
    "id": 73,
    "original_language": "en",
    "original_title": "American History X",
    "overview": "Derek Vineyard is paroled after serving 3 years in prison for killing two African-American men. Through his brother, Danny Vineyard's narration, we learn that before going to prison, Derek was a skinhead and the leader of a violent white supremacist gang that committed acts of racial crime throughout L.A. and his actions greatly influenced Danny. Reformed and fresh out of prison, Derek severs contact with the gang and becomes determined to keep Danny from going down the same violent path as he did.",
    "popularity": 29.943,
    "poster_path": "/c2gsmSQ2Cqv8zosqKOCwRS0GFBS.jpg",
    "release_date": "1998-07-01",
    "title": "American History X",
    "video": false,
    "vote_average": 8.355,
    "vote_count": 10343
  },
  {
    "adult": false,
    "backdrop_path": "/vL5LR6WdxWPjLPFRLe133jXWsh5.jpg",
    "genre_ids": [28, 12, 14, 878],
    "id": 19995,
    "original_language": "en",
    "original_title": "Avatar",
    "overview": "In the 22nd century, a paraplegic Marine is dispatched to the moon Pandora on a unique mission, but becomes torn between following orders and protecting an alien civilization.",
    "popularity": 201.185,
    "poster_path": "/jRXYjXNq0Cs2TcJjLkki24MLp7u.jpg",
    "release_date": "2009-12-15",
    "title": "Avatar",
    "video": false,
    "vote_average": 7.569,
    "vote_count": 28980
  },
  {
    "adult": false,
    "backdrop_path": "/8AE7M2lMsyvowfT36porzGtmOtI.jpg",
    "genre_ids": [878, 18, 10749],
    "id": 38,
    "original_language": "en",
    "original_title": "Eternal Sunshine of the Spotless Mind",
    "overview": "Joel Barish, heartbroken that his girlfriend underwent a procedure to erase him from her memory, decides to do the same. However, as he watches his memories of her fade away, he realises that he still loves her, and may be too late to correct his mistake.",
    "popularity": 36.729,
    "poster_path": "/5MwkWH9tYHv3mV9OdYTMR5qreIz.jpg",
    "release_date": "2004-03-19",
    "title": "Eternal Sunshine of the Spotless Mind",
    "video": false,
    "vote_average": 8.1,
    "vote_count": 13294
  },
  {
    "adult": false,
    "backdrop_path": "/eIi3klFf7mp3oL5EEF4mLIDs26r.jpg",
    "genre_ids": [878, 18, 53],
    "id": 78,
    "original_language": "en",
    "original_title": "Blade Runner",
    "overview": "In the smog-choked dystopian Los Angeles of 2019, blade runner Rick Deckard is called out of retirement to terminate a quartet of replicants who have escaped to Earth seeking their creator for a way to extend their short life spans.",
    "popularity": 47.122,
    "poster_path": "/63N9uy8nd9j7Eog2axPQ8lbr3Wj.jpg",
    "release_date": "1982-06-25",
    "title": "Blade Runner",
    "video": false,
    "vote_average": 7.933,
    "vote_count": 12351
  },
  {
    "adult": false,
    "backdrop_path": "/fK5ssgvtI43z19FoWigdlqgpLRE.jpg",
    "genre_ids": [16, 10751, 878],
    "id": 10681,
    "original_language": "en",
    "original_title": "WALL·E",
    "overview": "WALL·E is the last robot left on an Earth that has been overrun with garbage and all humans have fled to outer space. For 700 years he has continued to try and clean up the mess, but has developed some rather interesting human-like qualities. When a ship arrives with a sleek new type of robot, WALL·E thinks he's finally found a friend and stows away on the ship when it leaves.",
    "popularity": 72.81,
    "poster_path": "/Agc6lw8pb6BIGVeguvdjDT0p9Mb.jpg",
    "release_date": "2008-06-22",
    "title": "WALL·E",
    "video": false,
    "vote_average": 8.075,
    "vote_count": 16926
  },
  {
    "adult": false,
    "backdrop_path": "/aDYSnJAK0BTVeE8osOy22Kz3SXY.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": 81.207,
    "poster_path": "/6FfCtAuVAW8XJjZ7eWeLibRLWTw.jpg",
    "release_date": "1977-05-25",
    "title": "Star Wars",
    "video": false,
    "vote_average": 8.208,
    "vote_count": 18531
  }
]

total_pages

number

The total number of pages available in the response data.

Example:

4

total_results

number

The total number of movie results returned from the query.

Example:

80