Get watchlist

get

https://api.trakt.tv/users/{id}/watchlist/{type}/{sort_by}/{sort_how}

🔓 OAuth Optional 📄 Pagination ✨ Extended Info 🎚 Filters

Returns all items in a user's watchlist filtered by type.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

string

required

The slug that identifies the user, or "me" for the authenticated user.

type

string

required

Watchlist media type filter.

sort_by

string

required

Sort by a specific property.

sort_how

string

required

Sort direction.

Query Params

extended

string

Extended information to include in the response.

sort_by

string | null

The field to sort by

sort_how

string | null

enum

The direction to sort in

Allowed:

page

integer | null

The page number to retrieve

limit

integer | null

The number of items per page

watchnow

string | null

enum

Use "favorites" for streaming on a favorite service of the user.
Use "any" for streaming on any service in the user's country.
Use "any_all" for streaming on any service in all countries.
Use "free" for streaming for free in the user's country.
Use "free_all" for streaming for free in all countries.
Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country.
Use "subscriptions_all" streaming on any subscription service in all countries

Allowed:

genres

string | null

subgenres

string | null

years

string | null

ratings

string | null

start_date

string | null

end_date

string | null

runtimes

string | null

countries

string | null

certifications

string | null

hide

string | null

enum

Response

Language

Credentials

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200200