Introduction
Authentication
Guest Sessions
Account
Keyword
Collections
Movies
TV Series
- GETDetails
- GETAccount States
- GETAggregate Credits
- GETAlternative Titles
- GETChanges
- GETContent Ratings
- GETCredits
- GETEpisode Groups
- GETExternal IDS
- GETImages
- GETKeywords
- GETLatest
- GETLists
- GETRecommendations
- GETReviews
- GETScreened Theatrically
- GETSimilar
- GETTranslations
- GETVideos
- GETStreaming Providers
- POSTAdd Rating
- DELDelete Ratings
TV Series Lists
TV Seasons
TV Providers
TV Episode Groups
Watch Providers
People
People List
Credits
Review
Certifications
Account
Movies Watchlist
This endpoint retrieves your movie watchlist.
GET
/
3
/
account
/
{account_id}
/
watchlist
/
movies
curl --request GET \
--url https://api.themoviedb.org/3/account/%7B{account_id}%7D/watchlist/movies \
--header 'Authorization: Bearer <token>'
{
"page": 1,
"results": [
{
"adult": false,
"backdrop_path": "/tElnmtQ6yz1PjN1kePNl8yMSb59.jpg",
"genre_ids": [
16,
12,
10751,
35
],
"id": 1241982,
"original_language": "en",
"original_title": "Moana 2",
"overview": "After receiving an unexpected call from her wayfinding ancestors, Moana journeys alongside Maui and a new crew to the far seas of Oceania and into dangerous, long-lost waters for an adventure unlike anything she's ever faced.",
"popularity": 5883.763,
"poster_path": "/yh64qw9mgXBvlaWDi7Q9tpUBAvH.jpg",
"release_date": "2024-11-27",
"title": "Moana 2",
"video": false,
"vote_average": 6.938,
"vote_count": 316
}
],
"total_pages": 1,
"total_results": 1
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Query Parameters
This represents the movie language.
Example:
"en"
This represents the page number.
Example:
"1"
This specifies the order in which the retrieved list will be displayed.
Example:
"created_at.asc"
Response
200 - application/json
Movies Watchlist
The response is of type object
.
curl --request GET \
--url https://api.themoviedb.org/3/account/%7B{account_id}%7D/watchlist/movies \
--header 'Authorization: Bearer <token>'
{
"page": 1,
"results": [
{
"adult": false,
"backdrop_path": "/tElnmtQ6yz1PjN1kePNl8yMSb59.jpg",
"genre_ids": [
16,
12,
10751,
35
],
"id": 1241982,
"original_language": "en",
"original_title": "Moana 2",
"overview": "After receiving an unexpected call from her wayfinding ancestors, Moana journeys alongside Maui and a new crew to the far seas of Oceania and into dangerous, long-lost waters for an adventure unlike anything she's ever faced.",
"popularity": 5883.763,
"poster_path": "/yh64qw9mgXBvlaWDi7Q9tpUBAvH.jpg",
"release_date": "2024-11-27",
"title": "Moana 2",
"video": false,
"vote_average": 6.938,
"vote_count": 316
}
],
"total_pages": 1,
"total_results": 1
}
Assistant
Responses are generated using AI and may contain mistakes.