Rated movies

This endpoint get a users list of rated 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

Rated movies

page

number

Represents the current page of the results being returned. It starts from 1 and increments with each new page.

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

A boolean indicating whether the movie is categorized as adult content (true) or not (false).

Example:

false

results.backdrop_path

string

The URL path to the movie's backdrop image, that can be displayed behind the movie title.

Example:

"/dUVbWINfRMGojGZRcO6GF1Z2nV8.jpg"

results.genre_ids

number[]

An array of integers representing genre IDs for the movie. Each ID corresponds to a specific genre (e.g., 12 for Adventure, 28 for Action).

Example:

[12, 14, 28]

results.id

number

An integer representing a unique identifier for the movie within the database.

Example:

120

results.original_language

string

A string that specifies the primary language in which the movie was originally produced. For example, "en" stands for English.

Example:

"en"

results.original_title

string

A string indicating the original title of the movie as it was released in its original country.

Example:

"The Lord of the Rings: The Fellowship of the Ring"

results.overview

string

A brief summary of the movie's plot or theme, providing an insight into the story.

Example:

"Young hobbit Frodo Baggins, after inheriting a mysterious ring from his uncle Bilbo, must leave his home in order to keep it from falling into the hands of its evil creator. Along the way, a fellowship is formed to protect the ringbearer and make sure that the ring arrives at its final destination: Mt. Doom, the only place where it can be destroyed."

results.popularity

number

A numeric value representing the popularity of the movie, calculated based on various factors such as viewership and engagement metrics.

Example:

84.737

results.poster_path

string

Indicates the path to the movie's poster image.

Example:

"/6oom5QYQ2yQTMJIbnvbkBL9cHo6.jpg"

results.rating

number

An integer that serves as a custom rating value that may reflect how the movie is perceived overall.

Example:

8

results.release_date

string

A string representing the date when the movie was first released to the public, following the format "YYYY-MM-DD". In this case, for example, "2001-12-18" denotes December 18, 2001.

Example:

"2001-12-18"

results.title

string

A text representation of the film's name as recognized and referred to by its audience.

Example:

"The Lord of the Rings: The Fellowship of the Ring"

results.video

boolean

A boolean indicating whether the movie has associated video content (like trailers) available (true) or not (false).

Example:

false

results.vote_average

number

A numeric value that indicates the average rating the movie has received, generally on a scale of 0-10.

Example:

8.396

results.vote_count

number

An integer denoting the number of votes or ratings that have been submitted for the movie.

Example:

22579

Example:

[
  {
    "adult": false,
    "backdrop_path": "/dUVbWINfRMGojGZRcO6GF1Z2nV8.jpg",
    "genre_ids": [12, 14, 28],
    "id": 120,
    "original_language": "en",
    "original_title": "The Lord of the Rings: The Fellowship of the Ring",
    "overview": "Young hobbit Frodo Baggins, after inheriting a mysterious ring from his uncle Bilbo, must leave his home in order to keep it from falling into the hands of its evil creator. Along the way, a fellowship is formed to protect the ringbearer and make sure that the ring arrives at its final destination: Mt. Doom, the only place where it can be destroyed.",
    "popularity": 84.737,
    "poster_path": "/6oom5QYQ2yQTMJIbnvbkBL9cHo6.jpg",
    "rating": 8,
    "release_date": "2001-12-18",
    "title": "The Lord of the Rings: The Fellowship of the Ring",
    "video": false,
    "vote_average": 8.396,
    "vote_count": 22579
  },
  {
    "adult": false,
    "backdrop_path": "/YL3GPOiDcNraIJOVDCZsoOBoDy.jpg",
    "genre_ids": [878, 28, 12, 53],
    "id": 106,
    "original_language": "en",
    "original_title": "Predator",
    "overview": "A team of elite commandos on a secret mission in a Central American jungle come to find themselves hunted by an extraterrestrial warrior.",
    "popularity": 62.969,
    "poster_path": "/k3mW4qfJo6SKqe6laRyNGnbB9n5.jpg",
    "rating": 6,
    "release_date": "1987-06-12",
    "title": "Predator",
    "video": false,
    "vote_average": 7.491,
    "vote_count": 6943
  },
  {
    "adult": false,
    "backdrop_path": "/dqK9Hag1054tghRQSqLSfrkvQnA.jpg",
    "genre_ids": [18, 28, 80, 53],
    "id": 155,
    "original_language": "en",
    "original_title": "The Dark Knight",
    "overview": "Batman raises the stakes in his war on crime. With the help of Lt. Jim Gordon and District Attorney Harvey Dent, Batman sets out to dismantle the remaining criminal organizations that plague the streets. The partnership proves to be effective, but they soon find themselves prey to a reign of chaos unleashed by a rising criminal mastermind known to the terrified citizens of Gotham as the Joker.",
    "popularity": 83.151,
    "poster_path": "/qJ2tW6WMUDux911r6m7haRef0WH.jpg",
    "rating": 9,
    "release_date": "2008-07-14",
    "title": "The Dark Knight",
    "video": false,
    "vote_average": 8.509,
    "vote_count": 29582
  },
  {
    "adult": false,
    "backdrop_path": "/yzqaKAhglTrkeOfuIXYYArf0WnA.jpg",
    "genre_ids": [16, 10751],
    "id": 12,
    "original_language": "en",
    "original_title": "Finding Nemo",
    "overview": "Nemo, an adventurous young clownfish, is unexpectedly taken from his Great Barrier Reef home to a dentist's office aquarium. It's up to his worrisome father Marlin and a friendly but forgetful fish Dory to bring Nemo home -- meeting vegetarian sharks, surfer dude turtles, hypnotic jellyfish, hungry seagulls, and more along the way.",
    "popularity": 94.545,
    "poster_path": "/5lc6nQc0VhWFYFbNv016xze8Jvy.jpg",
    "rating": 8,
    "release_date": "2003-05-30",
    "title": "Finding Nemo",
    "video": false,
    "vote_average": 7.822,
    "vote_count": 17590
  },
  {
    "adult": false,
    "backdrop_path": "/ysKahAEPP8h6MInuLjr0xuZOTjh.jpg",
    "genre_ids": [80, 35],
    "id": 107,
    "original_language": "en",
    "original_title": "Snatch",
    "overview": "Unscrupulous boxing promoters, violent bookmakers, a Russian gangster, incompetent amateur robbers and supposedly Jewish jewelers fight to track down a priceless stolen diamond.",
    "popularity": 32.43,
    "poster_path": "/56mOJth6DJ6JhgoE2jtpilVqJO.jpg",
    "rating": 8,
    "release_date": "2000-09-01",
    "title": "Snatch",
    "video": false,
    "vote_average": 7.803,
    "vote_count": 7985
  },
  {
    "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",
    "rating": 9,
    "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": "/3h1JZGDhZ8nzxdgvkxha0qBqi05.jpg",
    "genre_ids": [35, 18, 10749],
    "id": 13,
    "original_language": "en",
    "original_title": "Forrest Gump",
    "overview": "A man with a low IQ has accomplished great things in his life and been present during significant historic events—in each case, far exceeding what anyone imagined he could do. But despite all he has achieved, his one true love eludes him.",
    "popularity": 62.225,
    "poster_path": "/arw2vcBveWOVZr6pxd9XTd1TdQa.jpg",
    "rating": 9,
    "release_date": "1994-06-23",
    "title": "Forrest Gump",
    "video": false,
    "vote_average": 8.5,
    "vote_count": 24536
  },
  {
    "adult": false,
    "backdrop_path": "/xKb6mtdfI5Qsggc44Hr9CCUDvaj.jpg",
    "genre_ids": [28, 53, 878],
    "id": 280,
    "original_language": "en",
    "original_title": "Terminator 2: Judgment Day",
    "overview": "Nearly 10 years have passed since Sarah Connor was targeted for termination by a cyborg from the future. Now her son, John, the future leader of the resistance, is the target for a newer, more deadly terminator. Once again, the resistance has managed to send a protector back to attempt to save John and his mother Sarah.",
    "popularity": 66.674,
    "poster_path": "/5M0j0B18abtBI5gi2RhfjjurTqb.jpg",
    "rating": 8,
    "release_date": "1991-07-03",
    "title": "Terminator 2: Judgment Day",
    "video": false,
    "vote_average": 8.096,
    "vote_count": 11255
  },
  {
    "adult": false,
    "backdrop_path": "/8bQbejOvAKe78RXxpkfM04n0K18.jpg",
    "genre_ids": [14, 35],
    "id": 310,
    "original_language": "en",
    "original_title": "Bruce Almighty",
    "overview": "Bruce Nolan toils as a 'human interest' television reporter in Buffalo, N.Y., but despite his high ratings and the love of his beautiful girlfriend, Bruce remains unfulfilled. At the end of the worst day in his life, he angrily ridicules God—and the Almighty responds, endowing Bruce with all of His divine powers.",
    "popularity": 35.483,
    "poster_path": "/f0QqG14SZYYZcV4VWykVc5w13dz.jpg",
    "rating": 8,
    "release_date": "2003-05-23",
    "title": "Bruce Almighty",
    "video": false,
    "vote_average": 6.7,
    "vote_count": 9757
  },
  {
    "adult": false,
    "backdrop_path": "/lt1rGQSqhk2T2T4lHo6CTQYvoWP.jpg",
    "genre_ids": [53, 28, 80],
    "id": 187,
    "original_language": "en",
    "original_title": "Sin City",
    "overview": "Welcome to Sin City. This town beckons to the tough, the corrupt, the brokenhearted. Some call it dark… Hard-boiled. Then there are those who call it home — Crooked cops, sexy dames, desperate vigilantes. Some are seeking revenge, others lust after redemption, and then there are those hoping for a little of both. A universe of unlikely and reluctant heroes still trying to do the right thing in a city that refuses to care.",
    "popularity": 23.715,
    "poster_path": "/i66G50wATMmPrvpP95f0XP6ZdVS.jpg",
    "rating": 8,
    "release_date": "2005-04-01",
    "title": "Sin City",
    "video": false,
    "vote_average": 7.437,
    "vote_count": 7311
  },
  {
    "adult": false,
    "backdrop_path": "/tmU7GeKVybMWFButWEGl2M4GeiP.jpg",
    "genre_ids": [18, 80],
    "id": 238,
    "original_language": "en",
    "original_title": "The Godfather",
    "overview": "Spanning the years 1945 to 1955, a chronicle of the fictional Italian-American Corleone crime family. When organized crime family patriarch, Vito Corleone barely survives an attempt on his life, his youngest son, Michael steps in to take care of the would-be killers, launching a campaign of bloody revenge.",
    "popularity": 100.932,
    "poster_path": "/3bhkrj58Vtu7enYsRolD1fZdja1.jpg",
    "rating": 9,
    "release_date": "1972-03-14",
    "title": "The Godfather",
    "video": false,
    "vote_average": 8.712,
    "vote_count": 17812
  },
  {
    "adult": false,
    "backdrop_path": "/wOfzdzC0QZyhUIlyjeMuUYSb8Ax.jpg",
    "genre_ids": [18, 10749],
    "id": 289,
    "original_language": "en",
    "original_title": "Casablanca",
    "overview": "In Casablanca, Morocco in December 1941, a cynical American expatriate meets a former lover, with unforeseen complications.",
    "popularity": 17.927,
    "poster_path": "/5K7cOHoay2mZusSLezBOY0Qxh8a.jpg",
    "rating": 8,
    "release_date": "1942-11-26",
    "title": "Casablanca",
    "video": false,
    "vote_average": 8.173,
    "vote_count": 4695
  },
  {
    "adult": false,
    "backdrop_path": "/747dgDfL5d8esobk7h4odaOFhUq.jpg",
    "genre_ids": [80, 18, 53],
    "id": 275,
    "original_language": "en",
    "original_title": "Fargo",
    "overview": "Jerry, a small-town Minnesota car salesman is bursting at the seams with debt... but he's got a plan. He's going to hire two thugs to kidnap his wife in a scheme to collect a hefty ransom from his wealthy father-in-law. It's going to be a snap and nobody's going to get hurt... until people start dying. Enter Police Chief Marge, a coffee-drinking, parka-wearing - and extremely pregnant - investigator who'll stop at nothing to get her man. And if you think her small-time investigative skills will give the crooks a run for their ransom... you betcha!",
    "popularity": 20.791,
    "poster_path": "/rt7cpEr1uP6RTZykBFhBTcRaKvG.jpg",
    "rating": 8,
    "release_date": "1996-03-08",
    "title": "Fargo",
    "video": false,
    "vote_average": 7.87,
    "vote_count": 7007
  },
  {
    "adult": false,
    "backdrop_path": "/bsaA9qtIR6VTDQykXdBzJc8V5rS.jpg",
    "genre_ids": [12, 14, 9648],
    "id": 675,
    "original_language": "en",
    "original_title": "Harry Potter and the Order of the Phoenix",
    "overview": "Returning for his fifth year of study at Hogwarts, Harry is stunned to find that his warnings about the return of Lord Voldemort have been ignored. Left with no choice, Harry takes matters into his own hands, training a small group of students to defend themselves against the dark arts.",
    "popularity": 118.896,
    "poster_path": "/5aOyriWkPec0zUDxmHFP9qMmBaj.jpg",
    "rating": 8,
    "release_date": "2007-06-28",
    "title": "Harry Potter and the Order of the Phoenix",
    "video": false,
    "vote_average": 7.687,
    "vote_count": 17658
  },
  {
    "adult": false,
    "backdrop_path": "/r1gEZd7BoXtLNEQSNMqfsMlMtIz.jpg",
    "genre_ids": [12, 28, 18, 53],
    "id": 503,
    "original_language": "en",
    "original_title": "Poseidon",
    "overview": "A packed cruise ship traveling the Atlantic is hit and overturned by a massive wave, compelling the passengers to begin a dramatic fight for their lives.",
    "popularity": 22.847,
    "poster_path": "/cCx2Ead8KoZhHofsAAr7tyrjfDo.jpg",
    "rating": 6,
    "release_date": "2006-05-10",
    "title": "Poseidon",
    "video": false,
    "vote_average": 5.848,
    "vote_count": 1890
  },
  {
    "adult": false,
    "backdrop_path": "/eGhjeUbzttA3E4flxdAm8gHz4h4.jpg",
    "genre_ids": [28, 12, 10752],
    "id": 1271,
    "original_language": "en",
    "original_title": "300",
    "overview": "Based on Frank Miller's graphic novel, \"300\" is very loosely based the 480 B.C. Battle of Thermopylae, where the King of Sparta led his army against the advancing Persians; the battle is said to have inspired all of Greece to band together against the Persians, and helped usher in the world's first democracy.",
    "popularity": 49.667,
    "poster_path": "/9W49fy5G7v9Ed3CXtvMi41YqZtt.jpg",
    "rating": 8,
    "release_date": "2007-03-07",
    "title": "300",
    "video": false,
    "vote_average": 7.17,
    "vote_count": 12491
  }
]

total_pages

number

The total number of pages available for the query results.

Example:

47

total_results

number

The total number of results that meet the criteria of the query.

Example:

940