Video — entry 031 of 37

Trakt

Verified Jul 2026

Trakt is a social movie/TV tracking platform (watch history, ratings, "scrobbling") whose free JSON API lets developers build on top of user watch data via a registered app's API key plus OAuth for user-scoped actions. Its legacy Apiary-hosted docs are aging infrastructure that intermittently 502s, so its actively maintained API contract now lives in Trakt's own GitHub org.

tv-datamovie-dataoauthsocial-tracking

Visit trakt.tv ↗Read the docs ↗More Video

AuthenticationAPI KeySign up with the provider to obtain credentials.

HTTPSSupportedTraffic is encrypted in transit.

CORSEnabledCallable directly from browser JavaScript.

PricingFreemiumA usable free tier exists, with paid plans for more volume.

FormatsJSONResponses can be requested as JSON.

GreatAPIs Score

Score81out of 100

Authentication15/25API key required

Pricing17/20Freemium tier available

Docs20/20Machine-readable spec file bundled

Formats9/15Single response format

Freshness20/20Verified within 6 months

Embed this badge

<a href="https://greatapis.com/api/trakt/"><img src="https://greatapis.com/badge/trakt.svg" alt="Scored 81 on greatapis.com"></a>

Auth quickstart

Sign up with the provider to get an API key.
Send it on every request as a headertrakt-api-key: <key>

Stored keyNo key stored

Your key is stored only in this browser (localStorage) and sent directly to the API — never to greatapis.

Endpoints

Servers

https://api.trakt.tvhttps://api-staging.trakt.tvhttps://apiz.trakt.tv

Auth

traktAPItraktOAuth

calendars12

GET/calendars/releases/hot/finales/{start_date}/{days}Get hot finales

Parameters

Name	In	Required	Type
`start_date`	path	yes	string
`days`	path	yes	integer
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

GET/calendars/releases/hot/new/{start_date}/{days}Get hot new shows

Parameters

Name	In	Required	Type
`start_date`	path	yes	string
`days`	path	yes	integer
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

GET/calendars/releases/hot/premieres/{start_date}/{days}Get hot premieres

Parameters

Name	In	Required	Type
`start_date`	path	yes	string
`days`	path	yes	integer
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

GET/calendars/releases/hot/{start_date}/{days}Get hot releases

Parameters

Name	In	Required	Type
`start_date`	path	yes	string
`days`	path	yes	integer
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`type`	query	no	string
`group`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

GET/calendars/{target}/dvd/{start_date}/{days}Get DVD releases

Parameters

Name	In	Required	Type
`target`	path	yes	string
`start_date`	path	yes	string
`days`	path	yes	integer
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

GET/calendars/{target}/media/{start_date}/{days}Get media

Parameters

Name	In	Required	Type
`target`	path	yes	string
`start_date`	path	yes	string
`days`	path	yes	integer
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`type`	query	no	string
`group`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

GET/calendars/{target}/movies/{start_date}/{days}Get movies

Parameters

Name	In	Required	Type
`target`	path	yes	string
`start_date`	path	yes	string
`days`	path	yes	integer
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

GET/calendars/{target}/shows/finales/{start_date}/{days}Get finales

Parameters

Name	In	Required	Type
`target`	path	yes	string
`start_date`	path	yes	string
`days`	path	yes	integer
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

GET/calendars/{target}/shows/new/{start_date}/{days}Get new shows

Parameters

Name	In	Required	Type
`target`	path	yes	string
`start_date`	path	yes	string
`days`	path	yes	integer
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

GET/calendars/{target}/shows/premieres/{start_date}/{days}Get season premieres

Parameters

Name	In	Required	Type
`target`	path	yes	string
`start_date`	path	yes	string
`days`	path	yes	integer
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

GET/calendars/{target}/shows/{start_date}/{days}Get shows

Parameters

Name	In	Required	Type
`target`	path	yes	string
`start_date`	path	yes	string
`days`	path	yes	integer
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean
`group`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

GET/calendars/{target}/streaming/{start_date}/{days}Get streaming releases

Parameters

Name	In	Required	Type
`target`	path	yes	string
`start_date`	path	yes	string
`days`	path	yes	integer
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

certifications3

GET/certifications/moviesGet movie certifications

Responses

Status	Description	Schema
`200`	200	—

GET/certifications/showsGet show certifications

Responses

Status	Description	Schema
`200`	200	—

GET/certifications/{type}Get certifications

Parameters

Name	In	Required	Type
`type`	path	yes	string

Responses

Status	Description	Schema
`200`	200	—

checkin2

POST/checkinCheck into an item

Request body

application/json

Responses

Status	Description	Schema
`200`	200	—
`409`	409	—

DELETE/checkinDelete any active checkins

Responses

Status	Description	Schema
`204`	204	—

comments18

POST/comments/Post a comment

Request body

application/json

Responses

Status	Description	Schema
`201`	201	—

GET/comments/recent/{comment_type}/{type}Get recently created comments

Parameters

Name	In	Required	Type
`comment_type`	path	yes	string
`type`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	string
`include_replies`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

GET/comments/trending/{comment_type}/{type}Get trending comments

Parameters

Name	In	Required	Type
`comment_type`	path	yes	string
`type`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	string
`include_replies`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

GET/comments/updates/{comment_type}/{type}Get recently updated comments

Parameters

Name	In	Required	Type
`comment_type`	path	yes	string
`type`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	string
`include_replies`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

GET/comments/{id}Get a comment or reply

Parameters

Name	In	Required	Type
`id`	path	yes	string

Responses

Status	Description	Schema
`200`	200	—

PUT/comments/{id}/Update a comment or reply

Parameters

Name	In	Required	Type
`id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`200`	200	—

DELETE/comments/{id}/Delete a comment or reply

Parameters

Name	In	Required	Type
`id`	path	yes	string

Responses

Status	Description	Schema
`204`	204	—

GET/comments/{id}/itemGet the attached media item

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

POST/comments/{id}/likeLike a comment

Parameters

Name	In	Required	Type
`id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`204`	204	—

DELETE/comments/{id}/likeRemove like on a comment

Parameters

Name	In	Required	Type
`id`	path	yes	string

Responses

Status	Description	Schema
`204`	204	—

GET/comments/{id}/likesGet all users who liked a comment

Parameters

Name	In	Required	Type
`id`	path	yes	string
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/comments/{id}/reactions/Get comment reactions

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

GET/comments/{id}/reactions/summaryGet reaction summary

Parameters

Name	In	Required	Type
`id`	path	yes	string

Responses

Status	Description	Schema
`200`	200	—

POST/comments/{id}/reactions/{reaction_type}Add comment reaction

Parameters

Name	In	Required	Type
`id`	path	yes	string
`reaction_type`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`201`	201	—

DELETE/comments/{id}/reactions/{reaction_type}Remove comment reaction

Parameters

Name	In	Required	Type
`id`	path	yes	string
`reaction_type`	path	yes	string

Responses

Status	Description	Schema
`204`	204	—

GET/comments/{id}/repliesGet replies for a comment

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

POST/comments/{id}/repliesPost a reply for a comment

Parameters

Name	In	Required	Type
`id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`201`	201	—

POST/comments/{id}/reportReport a comment

Parameters

Name	In	Required	Type
`id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`201`	201	—
`400`	400	—
`409`	409	—

countries1

GET/countries/{type}Get countries

Parameters

Name	In	Required	Type
`type`	path	yes	string

Responses

Status	Description	Schema
`200`	200	—

episodes2

POST/episodes/{id}/reportReport an episode

Parameters

Name	In	Required	Type
`id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`201`	201	—
`400`	400	—
`409`	409	—

GET/episodes/{id}/watchnow/{country}Get episode watch now sources

Parameters

Name	In	Required	Type
`id`	path	yes	—
`country`	path	yes	string
`links`	query	no	—
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

genres1

GET/genres/{type}Get genres

Parameters

Name	In	Required	Type
`type`	path	yes	string
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

languages1

GET/languages/{type}Get languages

Parameters

Name	In	Required	Type
`type`	path	yes	string

Responses

Status	Description	Schema
`200`	200	—

lists15

GET/lists/popularGet popular lists

Parameters

Name	In	Required	Type
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

GET/lists/popular/{type}Get popular lists

Parameters

Name	In	Required	Type
`type`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

GET/lists/trendingGet trending lists

Parameters

Name	In	Required	Type
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

GET/lists/trending/{type}Get trending lists

Parameters

Name	In	Required	Type
`type`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

GET/lists/{id}Get list

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

GET/lists/{id}/comments/{sort}Get all list comments

Parameters

Name	In	Required	Type
`id`	path	yes	string
`sort`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

GET/lists/{id}/items/movieGet movie list items

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—
`sort_by`	query	no	string
`sort_how`	query	no	string
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean
`page`	query	no	integer
`limit`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

GET/lists/{id}/items/movie,showGet media list items

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—
`sort_by`	query	no	string
`sort_how`	query	no	string
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean
`page`	query	no	integer
`limit`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

GET/lists/{id}/items/movie,show,episode,seasonGet all list items

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—
`sort_by`	query	no	string
`sort_how`	query	no	string
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean
`page`	query	no	integer
`limit`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

GET/lists/{id}/items/showGet show list items

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—
`sort_by`	query	no	string
`sort_how`	query	no	string
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean
`page`	query	no	integer
`limit`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

GET/lists/{id}/items/{type}/{sort_by}/{sort_how}Get items on a list

Parameters

Name	In	Required	Type
`id`	path	yes	string
`type`	path	yes	string
`sort_by`	path	yes	string
`sort_how`	path	yes	string
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean
`page`	query	no	integer
`limit`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

POST/lists/{id}/likeLike a list

Parameters

Name	In	Required	Type
`id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`204`	204	—

DELETE/lists/{id}/likeRemove like on a list

Parameters

Name	In	Required	Type
`id`	path	yes	string

Responses

Status	Description	Schema
`204`	204	—

GET/lists/{id}/likesGet all users who liked a list

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

POST/lists/{id}/reportReport a list

Parameters

Name	In	Required	Type
`id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`201`	201	—
`400`	400	—
`409`	409	—

media3

GET/media/anticipatedGet anticipated media

Parameters

Name	In	Required	Type
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

GET/media/popularGet popular media

Parameters

Name	In	Required	Type
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

GET/media/trendingGet trending media

Parameters

Name	In	Required	Type
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

movies31

GET/movies/anticipatedGet the most anticipated movies

Parameters

Name	In	Required	Type
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

GET/movies/boxofficeGet the weekend box office

Parameters

Name	In	Required	Type
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

GET/movies/collected/{period}Get the most collected movies

Parameters

Name	In	Required	Type
`period`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

GET/movies/favorited/{period}Get the most favorited movies

Parameters

Name	In	Required	Type
`period`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

GET/movies/hotGet hot movies

Parameters

Name	In	Required	Type
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

GET/movies/played/{period}Get the most played movies

Parameters

Name	In	Required	Type
`period`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

GET/movies/popularGet popular movies

Parameters

Name	In	Required	Type
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

GET/movies/streaming/{period}Get streaming movies

Parameters

Name	In	Required	Type
`period`	path	yes	string
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

GET/movies/trendingGet trending movies

Parameters

Name	In	Required	Type
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

GET/movies/updates/id/{start_date}Get recently updated movie Trakt IDs

Parameters

Name	In	Required	Type
`start_date`	path	yes	string
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/movies/updates/{start_date}Get recently updated movies

Parameters

Name	In	Required	Type
`start_date`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/movies/watched/{period}Get the most watched movies

Parameters

Name	In	Required	Type
`period`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

GET/movies/{id}Get a movie

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

GET/movies/{id}/aliasesGet all movie aliases

Parameters

Name	In	Required	Type
`id`	path	yes	string

Responses

Status	Description	Schema
`200`	200	—

GET/movies/{id}/comments/{sort}Get all movie comments

Parameters

Name	In	Required	Type
`id`	path	yes	string
`sort`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	string
`language`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

GET/movies/{id}/lists/{type}/{sort}Get lists containing this movie

Parameters

Name	In	Required	Type
`id`	path	yes	string
`sort`	path	yes	string
`type`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/movies/{id}/peopleGet all people for a movie

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

GET/movies/{id}/ratingsGet movie ratings

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

POST/movies/{id}/refreshRefresh movie metadata

Parameters

Name	In	Required	Type
`id`	path	yes	string
`images`	query	no	boolean

Request body

application/json

Responses

Status	Description	Schema
`201`	201	—

POST/movies/{id}/refresh/justwatchRefresh movie JustWatch links

Parameters

Name	In	Required	Type
`id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`201`	201	—

GET/movies/{id}/relatedGet related movies

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/movies/{id}/releases/{country}Get all movie releases

Parameters

Name	In	Required	Type
`id`	path	yes	string
`country`	path	yes	string

Responses

Status	Description	Schema
`200`	200	—

POST/movies/{id}/reportReport a movie

Parameters

Name	In	Required	Type
`id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`201`	201	—
`400`	400	—
`409`	409	—

GET/movies/{id}/sentimentsGet movie sentiments

Parameters

Name	In	Required	Type
`id`	path	yes	string

Responses

Status	Description	Schema
`200`	200	—

GET/movies/{id}/statsGet movie stats

Parameters

Name	In	Required	Type
`id`	path	yes	string

Responses

Status	Description	Schema
`200`	200	—

GET/movies/{id}/studiosGet movie studios

Parameters

Name	In	Required	Type
`id`	path	yes	string

Responses

Status	Description	Schema
`200`	200	—

GET/movies/{id}/translations/{language}Get all movie translations

Parameters

Name	In	Required	Type
`id`	path	yes	string
`language`	path	yes	string

Responses

Status	Description	Schema
`200`	200	—

GET/movies/{id}/videosGet all videos

Parameters

Name	In	Required	Type
`id`	path	yes	string

Responses

Status	Description	Schema
`200`	200	—

GET/movies/{id}/watchingGet users watching right now

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

GET/movies/{id}/watchnow/justwatch_links/{country}Get movie JustWatch links

Parameters

Name	In	Required	Type
`country`	path	yes	string
`id`	path	yes	string

Responses

Status	Description	Schema
`200`	200	—

GET/movies/{id}/watchnow/{country}Get movie watch now sources

Parameters

Name	In	Required	Type
`id`	path	yes	string
`country`	path	yes	string
`links`	query	no	—
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

networks1

GET/networksGet networks

Responses

Status	Description	Schema
`200`	200	—

notes5

POST/notesAdd notes

Request body

application/json

Responses

Status	Description	Schema
`201`	201	—

GET/notes/{id}Get a note

Parameters

Name	In	Required	Type
`id`	path	yes	string

Responses

Status	Description	Schema
`200`	200	—

PUT/notes/{id}Update a note

Parameters

Name	In	Required	Type
`id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`200`	200	—

DELETE/notes/{id}Delete a note

Parameters

Name	In	Required	Type
`id`	path	yes	string

Responses

Status	Description	Schema
`204`	204	—

GET/notes/{id}/itemGet the attached item

Parameters

Name	In	Required	Type
`id`	path	yes	string

Responses

Status	Description	Schema
`200`	200	—

oauth5

GET/oauth/authorizeAuthorize Application

Parameters

Name	In	Required	Type
`response_type`	query	no	string
`client_id`	query	no	string
`redirect_uri`	query	no	string
`state`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

POST/oauth/device/codeGenerate new device codes

Request body

application/json

Responses

Status	Description	Schema
`200`	200	—

POST/oauth/device/tokenPoll for the access_token

Request body

application/json

Responses

Status	Description	Schema
`200`	200	—
`400`	400	—

POST/oauth/revokeRevoke an access_token

Request body

application/json

Responses

Status	Description	Schema
`200`	200	—

POST/oauth/tokenExchange a token

Request body

application/json

Responses

Status	Description	Schema
`200`	200	—
`400`	400	—

people8

GET/people/updates/id/{start_date}Get recently updated people Trakt IDs

Parameters

Name	In	Required	Type
`start_date`	path	yes	string
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/people/updates/{start_date}Get recently updated people

Parameters

Name	In	Required	Type
`start_date`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/people/{id}/Get a single person

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

GET/people/{id}/lists/{type}/{sort}Get lists containing this person

Parameters

Name	In	Required	Type
`id`	path	yes	string
`sort`	path	yes	string
`type`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/people/{id}/moviesGet movie credits

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

POST/people/{id}/refreshRefresh person metadata

Parameters

Name	In	Required	Type
`id`	path	yes	string
`images`	query	no	boolean

Request body

application/json

Responses

Status	Description	Schema
`201`	201	—

POST/people/{id}/reportReport a person

Parameters

Name	In	Required	Type
`id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`201`	201	—
`400`	400	—
`409`	409	—

GET/people/{id}/showsGet show credits

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

recommendations4

GET/recommendations/movies/Get movie recommendations

Parameters

Name	In	Required	Type
`extended`	query	no	—
`limit`	query	yes	integer
`watch_window`	query	no	integer
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

DELETE/recommendations/movies/{id}Hide a movie recommendation

Parameters

Name	In	Required	Type
`id`	path	yes	—

Responses

Status	Description	Schema
`204`	204	—

GET/recommendations/shows/Get show recommendations

Parameters

Name	In	Required	Type
`extended`	query	no	—
`limit`	query	yes	integer
`watch_window`	query	no	integer
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

DELETE/recommendations/shows/{id}Hide a show recommendation

Parameters

Name	In	Required	Type
`id`	path	yes	—

Responses

Status	Description	Schema
`204`	204	—

scrobble3

POST/scrobble/pausePause watching in a media center

Request body

application/json

Responses

Status	Description	Schema
`201`	201	—

POST/scrobble/startStart watching in a media center

Request body

application/json

Responses

Status	Description	Schema
`201`	201	—

POST/scrobble/stopStop or finish watching in a media center

Request body

application/json

Responses

Status	Description	Schema
`201`	201	—

search6

POST/search/recent/Add recent search

Request body

application/json

Responses

Status	Description	Schema
`201`	201	—

POST/search/recent/removeRemove recent search

Request body

application/json

Responses

Status	Description	Schema
`204`	204	—

GET/search/recent_by_id/global/{type}Get trending search results

Parameters

Name	In	Required	Type
`type`	path	yes	—
`page`	query	no	integer
`limit`	query	no	integer
`query`	query	no	string
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

GET/search/{id_type}/{id}Get ID lookup results

Parameters

Name	In	Required	Type
`id_type`	path	yes	string
`id`	path	yes	string
`type`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

GET/search/{type}Get text query results

Parameters

Name	In	Required	Type
`type`	path	yes	—
`query`	query	no	string
`engine`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

GET/search/{type}/exactGet exact text query results

Parameters

Name	In	Required	Type
`type`	path	yes	—
`query`	query	no	string
`engine`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

seasons1

POST/seasons/{id}/reportReport a season

Parameters

Name	In	Required	Type
`id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`201`	201	—
`400`	400	—
`409`	409	—

shows60

GET/shows/anticipatedGet the most anticipated shows

Parameters

Name	In	Required	Type
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

GET/shows/collected/{period}Get the most collected shows

Parameters

Name	In	Required	Type
`period`	path	yes	string
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

GET/shows/favorited/{period}Get the most favorited shows

Parameters

Name	In	Required	Type
`period`	path	yes	string
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

GET/shows/hotGet hot shows

Parameters

Name	In	Required	Type
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

GET/shows/played/{period}Get the most played shows

Parameters

Name	In	Required	Type
`period`	path	yes	string
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

GET/shows/popularGet popular shows

Parameters

Name	In	Required	Type
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

GET/shows/streaming/{period}Get streaming shows

Parameters

Name	In	Required	Type
`period`	path	yes	string
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

GET/shows/trendingGet trending shows

Parameters

Name	In	Required	Type
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

GET/shows/updates/id/{start_date}Get recently updated show Trakt IDs

Parameters

Name	In	Required	Type
`start_date`	path	yes	string
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/shows/updates/{start_date}Get recently updated shows

Parameters

Name	In	Required	Type
`start_date`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/shows/watched/{period}Get the most watched shows

Parameters

Name	In	Required	Type
`period`	path	yes	string
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

GET/shows/{id}Get a single show

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

GET/shows/{id}/aliasesGet all show aliases

Parameters

Name	In	Required	Type
`id`	path	yes	string

Responses

Status	Description	Schema
`200`	200	—

GET/shows/{id}/certificationsGet all show certifications

Parameters

Name	In	Required	Type
`id`	path	yes	string

Responses

Status	Description	Schema
`200`	200	—

GET/shows/{id}/comments/{sort}Get all show comments

Parameters

Name	In	Required	Type
`id`	path	yes	string
`sort`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	string
`language`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

GET/shows/{id}/last_episodeGet last episode

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—
`204`	204	—

GET/shows/{id}/lists/{type}/{sort}Get lists containing this show

Parameters

Name	In	Required	Type
`id`	path	yes	string
`sort`	path	yes	string
`type`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/shows/{id}/next_episodeGet next episode

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—
`204`	204	—

GET/shows/{id}/peopleGet all people for a show

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

GET/shows/{id}/progress/collectionGet show collection progress

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—
`hidden`	query	no	boolean
`specials`	query	no	boolean
`count_specials`	query	no	boolean
`include_stats`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

GET/shows/{id}/progress/watchedGet show watched progress

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—
`hidden`	query	no	boolean
`specials`	query	no	boolean
`count_specials`	query	no	boolean
`include_stats`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

POST/shows/{id}/progress/watched/resetReset show progress

Parameters

Name	In	Required	Type
`id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`200`	200	—

DELETE/shows/{id}/progress/watched/resetUndo reset show progress

Parameters

Name	In	Required	Type
`id`	path	yes	string

Responses

Status	Description	Schema
`204`	204	—

GET/shows/{id}/ratingsGet show ratings

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

POST/shows/{id}/refreshRefresh show metadata

Parameters

Name	In	Required	Type
`id`	path	yes	string
`images`	query	no	boolean

Request body

application/json

Responses

Status	Description	Schema
`201`	201	—

POST/shows/{id}/refresh/justwatchRefresh show JustWatch links

Parameters

Name	In	Required	Type
`id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`201`	201	—

GET/shows/{id}/relatedGet related shows

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

POST/shows/{id}/reportReport a show

Parameters

Name	In	Required	Type
`id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`201`	201	—
`400`	400	—
`409`	409	—

GET/shows/{id}/seasonsGet all seasons for a show

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

GET/shows/{id}/seasons/{season}Get all episodes for a single season

Parameters

Name	In	Required	Type
`id`	path	yes	string
`season`	path	yes	integer
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

GET/shows/{id}/seasons/{season}/comments/{sort}Get all season comments

Parameters

Name	In	Required	Type
`id`	path	yes	string
`season`	path	yes	integer
`sort`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	string
`language`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

GET/shows/{id}/seasons/{season}/episodes/{episode}Get a single episode for a show

Parameters

Name	In	Required	Type
`id`	path	yes	string
`season`	path	yes	integer
`episode`	path	yes	integer
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

GET/shows/{id}/seasons/{season}/episodes/{episode}/comments/{sort}Get all episode comments

Parameters

Name	In	Required	Type
`id`	path	yes	string
`season`	path	yes	integer
`episode`	path	yes	integer
`sort`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	string
`language`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

GET/shows/{id}/seasons/{season}/episodes/{episode}/lists/{type}/{sort}Get lists containing this episode

Parameters

Name	In	Required	Type
`id`	path	yes	string
`season`	path	yes	integer
`episode`	path	yes	integer
`sort`	path	yes	string
`type`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/shows/{id}/seasons/{season}/episodes/{episode}/peopleGet all people for an episode

Parameters

Name	In	Required	Type
`id`	path	yes	string
`season`	path	yes	integer
`episode`	path	yes	integer
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

GET/shows/{id}/seasons/{season}/episodes/{episode}/ratingsGet episode ratings

Parameters

Name	In	Required	Type
`id`	path	yes	string
`season`	path	yes	integer
`episode`	path	yes	integer
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

POST/shows/{id}/seasons/{season}/episodes/{episode}/reportReport an episode

Parameters

Name	In	Required	Type
`id`	path	yes	string
`season`	path	yes	integer
`episode`	path	yes	integer

Request body

application/json

Responses

Status	Description	Schema
`201`	201	—
`400`	400	—
`409`	409	—

GET/shows/{id}/seasons/{season}/episodes/{episode}/statsGet episode stats

Parameters

Name	In	Required	Type
`id`	path	yes	string
`season`	path	yes	integer
`episode`	path	yes	integer

Responses

Status	Description	Schema
`200`	200	—

GET/shows/{id}/seasons/{season}/episodes/{episode}/translations/{language}Get all episode translations

Parameters

Name	In	Required	Type
`id`	path	yes	string
`season`	path	yes	integer
`episode`	path	yes	integer
`language`	path	yes	string

Responses

Status	Description	Schema
`200`	200	—

GET/shows/{id}/seasons/{season}/episodes/{episode}/videosGet all videos

Parameters

Name	In	Required	Type
`id`	path	yes	string
`season`	path	yes	integer
`episode`	path	yes	integer

Responses

Status	Description	Schema
`200`	200	—

GET/shows/{id}/seasons/{season}/episodes/{episode}/watchingGet users watching right now

Parameters

Name	In	Required	Type
`id`	path	yes	string
`season`	path	yes	integer
`episode`	path	yes	integer
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

GET/shows/{id}/seasons/{season}/episodes/{episode}/watchnow/{country}Get episode watch now sources

Parameters

Name	In	Required	Type
`id`	path	yes	string
`country`	path	yes	string
`season`	path	yes	integer
`episode`	path	yes	integer
`links`	query	no	—
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

GET/shows/{id}/seasons/{season}/infoGet single seasons for a show

Parameters

Name	In	Required	Type
`id`	path	yes	string
`season`	path	yes	integer
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

GET/shows/{id}/seasons/{season}/lists/{type}/{sort}Get lists containing this season

Parameters

Name	In	Required	Type
`id`	path	yes	string
`season`	path	yes	integer
`sort`	path	yes	string
`type`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/shows/{id}/seasons/{season}/peopleGet all people for a season

Parameters

Name	In	Required	Type
`id`	path	yes	string
`season`	path	yes	integer
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

GET/shows/{id}/seasons/{season}/ratingsGet season ratings

Parameters

Name	In	Required	Type
`id`	path	yes	string
`season`	path	yes	integer
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

POST/shows/{id}/seasons/{season}/reportReport a season

Parameters

Name	In	Required	Type
`id`	path	yes	string
`season`	path	yes	integer

Request body

application/json

Responses

Status	Description	Schema
`201`	201	—
`400`	400	—
`409`	409	—

GET/shows/{id}/seasons/{season}/statsGet season stats

Parameters

Name	In	Required	Type
`id`	path	yes	string
`season`	path	yes	integer

Responses

Status	Description	Schema
`200`	200	—

GET/shows/{id}/seasons/{season}/translations/{language}Get all season translations

Parameters

Name	In	Required	Type
`id`	path	yes	string
`season`	path	yes	integer
`language`	path	yes	string

Responses

Status	Description	Schema
`200`	200	—

GET/shows/{id}/seasons/{season}/videosGet all videos

Parameters

Name	In	Required	Type
`id`	path	yes	string
`season`	path	yes	integer

Responses

Status	Description	Schema
`200`	200	—

GET/shows/{id}/seasons/{season}/watchingGet users watching right now

Parameters

Name	In	Required	Type
`id`	path	yes	string
`season`	path	yes	integer
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

GET/shows/{id}/seasons/{season}/watchnow/justwatch_links/{country}Get season JustWatch links

Parameters

Name	In	Required	Type
`season`	path	yes	string
`country`	path	yes	string
`id`	path	yes	string

Responses

Status	Description	Schema
`200`	200	—

GET/shows/{id}/sentimentsGet show sentiments

Parameters

Name	In	Required	Type
`id`	path	yes	string

Responses

Status	Description	Schema
`200`	200	—

GET/shows/{id}/statsGet show stats

Parameters

Name	In	Required	Type
`id`	path	yes	string

Responses

Status	Description	Schema
`200`	200	—

GET/shows/{id}/studiosGet show studios

Parameters

Name	In	Required	Type
`id`	path	yes	string

Responses

Status	Description	Schema
`200`	200	—

GET/shows/{id}/translations/{language}Get all show translations

Parameters

Name	In	Required	Type
`id`	path	yes	string
`language`	path	yes	string

Responses

Status	Description	Schema
`200`	200	—

GET/shows/{id}/videosGet all videos

Parameters

Name	In	Required	Type
`id`	path	yes	string

Responses

Status	Description	Schema
`200`	200	—

GET/shows/{id}/watchingGet users watching right now

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

GET/shows/{id}/watchnow/justwatch_links/{country}Get show JustWatch links

Parameters

Name	In	Required	Type
`country`	path	yes	string
`id`	path	yes	string

Responses

Status	Description	Schema
`200`	200	—

GET/shows/{id}/watchnow/{country}Get show watch now sources

Parameters

Name	In	Required	Type
`id`	path	yes	string
`country`	path	yes	string
`links`	query	no	—
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

smart_lists2

GET/smart-lists/{list_id}Get smart list

Parameters

Name	In	Required	Type
`list_id`	path	yes	string

Responses

Status	Description	Schema
`200`	200	—
`404`	404	—

GET/smart-lists/{list_id}/items/{type}/{sort_by}/{sort_how}Get smart list items

Parameters

Name	In	Required	Type
`list_id`	path	yes	string
`type`	path	yes	string
`sort_by`	path	yes	string
`sort_how`	path	yes	string
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean
`page`	query	no	integer
`limit`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

social_recommendations2

GET/social_recommendations/movies/Get social movie recommendations

Parameters

Name	In	Required	Type
`extended`	query	no	—
`limit`	query	yes	integer
`watch_window`	query	no	integer
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

GET/social_recommendations/shows/Get social show recommendations

Parameters

Name	In	Required	Type
`extended`	query	no	—
`limit`	query	yes	integer
`watch_window`	query	no	integer
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

sync36

POST/sync/collectionAdd items to collection

Request body

application/json

Responses

Status	Description	Schema
`201`	201	—

GET/sync/collection/episodesGet episode collection

Parameters

Name	In	Required	Type
`extended`	query	no	—
`available_on`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/sync/collection/mediaGet media collection

Parameters

Name	In	Required	Type
`extended`	query	no	—
`available_on`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/sync/collection/minimal/episodesGet minimal episode collection

Parameters

Name	In	Required	Type
`available_on`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

GET/sync/collection/minimal/moviesGet minimal movie collection

Parameters

Name	In	Required	Type
`available_on`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

GET/sync/collection/minimal/showsGet minimal show collection

Parameters

Name	In	Required	Type
`available_on`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

GET/sync/collection/moviesGet movie collection

Parameters

Name	In	Required	Type
`extended`	query	no	—
`available_on`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

POST/sync/collection/removeRemove items from collection

Request body

application/json

Responses

Status	Description	Schema
`200`	200	—

GET/sync/collection/showsGet show collection

Parameters

Name	In	Required	Type
`extended`	query	no	—
`available_on`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

GET/sync/collection/{type}Get collection

Parameters

Name	In	Required	Type
`type`	path	yes	string
`extended`	query	no	—
`available_on`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

POST/sync/favoritesAdd items to favorites

Request body

application/json

Responses

Status	Description	Schema
`201`	201	—

PUT/sync/favoritesUpdate favorites

Request body

application/json

Responses

Status	Description	Schema
`200`	200	—

POST/sync/favorites/removeRemove items from favorites

Request body

application/json

Responses

Status	Description	Schema
`200`	200	—

POST/sync/favorites/reorderReorder favorited items

Request body

application/json

Responses

Status	Description	Schema
`200`	200	—

PUT/sync/favorites/{list_item_id}Update a favorite item

Parameters

Name	In	Required	Type
`list_item_id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`204`	204	—

GET/sync/favorites/{type}/{sort_by}/{sort_how}Get favorites

Parameters

Name	In	Required	Type
`type`	path	yes	string
`sort_by`	path	yes	string
`sort_how`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

POST/sync/historyAdd items to watched history

Request body

application/json

Responses

Status	Description	Schema
`200`	200	—

POST/sync/history/removeRemove items from history

Request body

application/json

Responses

Status	Description	Schema
`200`	200	—

GET/sync/history/{type}/{id}Get watched history

Parameters

Name	In	Required	Type
`type`	path	yes	string
`id`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer
`start_at`	query	no	string
`end_at`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

GET/sync/last_activitiesGet last activity

Responses

Status	Description	Schema
`200`	200	—

GET/sync/playback/moviesGet movie playback progress

Parameters

Name	In	Required	Type
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer
`start_at`	query	no	string
`end_at`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

DELETE/sync/playback/{id}Remove a playback item

Parameters

Name	In	Required	Type
`id`	path	yes	integer

Responses

Status	Description	Schema
`204`	204	—

GET/sync/playback/{type}Get playback progress

Parameters

Name	In	Required	Type
`type`	path	yes	string
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer
`start_at`	query	no	string
`end_at`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

GET/sync/progress/up_nextGet up next

Parameters

Name	In	Required	Type
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer
`sort_by`	query	no	string
`sort_how`	query	no	string
`include_stats`	query	no	boolean
`lifetime_stats`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

GET/sync/progress/up_next_nitroGet up next nitro

Parameters

Name	In	Required	Type
`page`	query	no	integer
`limit`	query	no	integer
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`sort_by`	query	no	string
`sort_how`	query	no	string
`intent`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

GET/sync/progress/watchedGet watched progress

Parameters

Name	In	Required	Type
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer
`sort_by`	query	no	string
`sort_how`	query	no	string
`lifetime_stats`	query	no	boolean
`hide_completed`	query	no	boolean
`hide_not_completed`	query	no	boolean
`only_rewatching`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

POST/sync/ratingsAdd new ratings

Request body

application/json

Responses

Status	Description	Schema
`201`	201	—

POST/sync/ratings/removeRemove ratings

Request body

application/json

Responses

Status	Description	Schema
`200`	200	—

GET/sync/ratings/{type}/{rating}Get ratings

Parameters

Name	In	Required	Type
`type`	path	yes	string
`rating`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/sync/watched/{type}Get watched

Parameters

Name	In	Required	Type
`type`	path	yes	string
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

POST/sync/watchlistAdd items to watchlist

Request body

application/json

Responses

Status	Description	Schema
`201`	201	—

PUT/sync/watchlistUpdate watchlist

Request body

application/json

Responses

Status	Description	Schema
`200`	200	—

POST/sync/watchlist/removeRemove items from watchlist

Request body

application/json

Responses

Status	Description	Schema
`200`	200	—

POST/sync/watchlist/reorderReorder watchlist items

Request body

application/json

Responses

Status	Description	Schema
`200`	200	—

PUT/sync/watchlist/{list_item_id}Update a watchlist item

Parameters

Name	In	Required	Type
`list_item_id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`204`	204	—

GET/sync/watchlist/{type}/{sort_by}/{sort_how}Get watchlist

Parameters

Name	In	Required	Type
`type`	path	yes	string
`sort_by`	path	yes	string
`sort_how`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

team1

GET/team/Get team members

Parameters

Name	In	Required	Type
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

users104

PUT/users/avatarUpdate avatar

Request body

application/json

Responses

Status	Description	Schema
`204`	204	—
`400`	400	—

GET/users/blockedGet blocked users

Responses

Status	Description	Schema
`200`	200	—

POST/users/hidden/calendar/removeRemove hidden calendar items

Request body

application/json

Responses

Status	Description	Schema
`200`	200	—

GET/users/hidden/droppedGet dropped shows

Parameters

Name	In	Required	Type
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/users/hidden/progress_watchedGet hidden progress items

Parameters

Name	In	Required	Type
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer
`type`	query	yes	string

Responses

Status	Description	Schema
`200`	200	—

POST/users/hidden/progress_watched/removeRemove hidden progress items

Request body

application/json

Responses

Status	Description	Schema
`200`	200	—

GET/users/hidden/{section}Get hidden items

Parameters

Name	In	Required	Type
`section`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer
`type`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

POST/users/hidden/{section}Add hidden items

Parameters

Name	In	Required	Type
`section`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`200`	200	—

POST/users/hidden/{section}/removeRemove hidden items

Parameters

Name	In	Required	Type
`section`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`200`	200	—

GET/users/reactions/commentsGet comment reactions

Parameters

Name	In	Required	Type
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

GET/users/requests/Get follow requests

Parameters

Name	In	Required	Type
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

GET/users/requests/followingGet pending following requests

Parameters

Name	In	Required	Type
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

POST/users/requests/{id}Approve follow request

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—

Request body

application/json

Responses

Status	Description	Schema
`200`	200	—
`404`	404	—

DELETE/users/requests/{id}Deny follow request

Parameters

Name	In	Required	Type
`id`	path	yes	string

Responses

Status	Description	Schema
`204`	204	—
`404`	404	—

POST/users/saved_filtersAdd saved filters

Request body

application/json

Responses

Status	Description	Schema
`201`	201	—

DELETE/users/saved_filters/{id}Delete saved filter

Parameters

Name	In	Required	Type
`id`	path	yes	integer

Responses

Status	Description	Schema
`204`	204	—
`404`	404	—

GET/users/saved_filters/{section}Get saved filters

Parameters

Name	In	Required	Type
`section`	path	yes	string
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

PUT/users/set_coverUpdate cover image

Request body

application/json

Responses

Status	Description	Schema
`204`	204	—
`400`	400	—

GET/users/settingsRetrieve settings

Parameters

Name	In	Required	Type
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

PUT/users/settingsUpdate settings

Request body

application/json

Responses

Status	Description	Schema
`201`	201	—

GET/users/settings/plex/Get Plex settings

Responses

Status	Description	Schema
`200`	200	—

PUT/users/settings/plex/Update Plex settings

Request body

application/json

Responses

Status	Description	Schema
`204`	204	—

POST/users/settings/plex/connectConnect Plex

Request body

application/json

Responses

Status	Description	Schema
`200`	200	—
`400`	400	—

DELETE/users/settings/plex/connectDisconnect Plex

Responses

Status	Description	Schema
`204`	204	—

GET/users/settings/plex/serversGet Plex servers

Responses

Status	Description	Schema
`200`	200	—
`401`	401	—
`502`	502	—
`504`	504	—

GET/users/settings/plex/servers/{server_id}Get Plex server accounts and libraries

Parameters

Name	In	Required	Type
`server_id`	path	yes	string

Responses

Status	Description	Schema
`200`	200	—
`401`	401	—
`404`	404	—
`422`	422	—
`502`	502	—
`503`	503	—
`504`	504	—

POST/users/settings/plex/syncSync Plex now

Request body

application/json

Responses

Status	Description	Schema
`201`	201	—
`422`	422	—

GET/users/syncs/Get data syncs

Parameters

Name	In	Required	Type
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/users/syncs/{id}Get a data sync

Parameters

Name	In	Required	Type
`id`	path	yes	integer

Responses

Status	Description	Schema
`200`	200	—
`404`	404	—

DELETE/users/syncs/{id}Undo a data sync

Parameters

Name	In	Required	Type
`id`	path	yes	integer

Responses

Status	Description	Schema
`204`	204	—
`404`	404	—

GET/users/syncs/{id}/pausedGet paused sync items

Parameters

Name	In	Required	Type
`id`	path	yes	integer
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—
`404`	404	—

GET/users/syncs/{id}/skippedGet skipped sync items

Parameters

Name	In	Required	Type
`id`	path	yes	integer
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—
`404`	404	—

GET/users/syncs/{type}Get data syncs by type

Parameters

Name	In	Required	Type
`type`	path	yes	string
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—
`404`	404	—

GET/users/{id}/Get user profile

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

POST/users/{id}/blockBlock this user

Parameters

Name	In	Required	Type
`id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`201`	201	—
`409`	409	—

DELETE/users/{id}/blockUnblock this user

Parameters

Name	In	Required	Type
`id`	path	yes	string

Responses

Status	Description	Schema
`204`	204	—

GET/users/{id}/collection/{type}Get collection

Parameters

Name	In	Required	Type
`id`	path	yes	string
`type`	path	yes	string
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/comments/{comment_type}/{type}Get comments

Parameters

Name	In	Required	Type
`id`	path	yes	string
`comment_type`	path	yes	string
`type`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer
`include_replies`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/favorites/comments/{sort}Get all favorites comments

Parameters

Name	In	Required	Type
`id`	path	yes	string
`sort`	path	yes	string
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/favorites/media/{sort}Get favorite media

Parameters

Name	In	Required	Type
`id`	path	yes	string
`sort`	path	yes	string
`extended`	query	no	—
`sort_by`	query	no	string
`sort_how`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/favorites/movies/{sort}Get favorite movies

Parameters

Name	In	Required	Type
`id`	path	yes	string
`sort`	path	yes	string
`extended`	query	no	—
`sort_by`	query	no	string
`sort_how`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/favorites/shows/{sort}Get favorite shows

Parameters

Name	In	Required	Type
`id`	path	yes	string
`sort`	path	yes	string
`extended`	query	no	—
`sort_by`	query	no	string
`sort_how`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/favorites/{type}/{sort_by}/{sort_how}Get favorites

Parameters

Name	In	Required	Type
`id`	path	yes	string
`type`	path	yes	string
`sort_by`	path	yes	string
`sort_how`	path	yes	string
`extended`	query	no	—
`sort_by`	query	no	string
`sort_how`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

POST/users/{id}/followFollow this user

Parameters

Name	In	Required	Type
`id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`201`	201	—
`409`	409	—

DELETE/users/{id}/followUnfollow this user

Parameters

Name	In	Required	Type
`id`	path	yes	string

Responses

Status	Description	Schema
`204`	204	—

GET/users/{id}/followersGet followers

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/followingGet following

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/friendsGet friends

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/history/Get watched history

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—
`start_at`	query	no	string
`end_at`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/history/episodesGet episode watched history

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`start_at`	query	no	string
`end_at`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/history/episodes/{item_id}Get history for an episode

Parameters

Name	In	Required	Type
`id`	path	yes	string
`item_id`	path	yes	string
`extended`	query	no	—
`start_at`	query	no	string
`end_at`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/history/moviesGet movie watched history

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`start_at`	query	no	string
`end_at`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/history/movies/{item_id}Get history for a movie

Parameters

Name	In	Required	Type
`id`	path	yes	string
`item_id`	path	yes	string
`extended`	query	no	—
`start_at`	query	no	string
`end_at`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/history/showsGet show watched history

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`start_at`	query	no	string
`end_at`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/history/shows/{item_id}Get history for a show

Parameters

Name	In	Required	Type
`id`	path	yes	string
`item_id`	path	yes	string
`extended`	query	no	—
`start_at`	query	no	string
`end_at`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/history/{type}/{item_id}Get watched history

Parameters

Name	In	Required	Type
`id`	path	yes	string
`item_id`	path	yes	string
`type`	path	yes	string
`extended`	query	no	—
`start_at`	query	no	string
`end_at`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/likes/{type}Get likes

Parameters

Name	In	Required	Type
`id`	path	yes	string
`type`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/listsGet a user's personal lists

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

POST/users/{id}/listsCreate personal list

Parameters

Name	In	Required	Type
`id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`201`	201	—

GET/users/{id}/lists/collaborationsGet all lists a user can collaborate on

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

POST/users/{id}/lists/reorderReorder a user's lists

Parameters

Name	In	Required	Type
`id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/lists/{list_id}/Get personal list

Parameters

Name	In	Required	Type
`id`	path	yes	string
`list_id`	path	yes	string
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

PUT/users/{id}/lists/{list_id}/Update personal list

Parameters

Name	In	Required	Type
`id`	path	yes	string
`list_id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`200`	200	—

DELETE/users/{id}/lists/{list_id}/Delete a user's personal list

Parameters

Name	In	Required	Type
`id`	path	yes	string
`list_id`	path	yes	string

Responses

Status	Description	Schema
`204`	204	—
`403`	403	—

GET/users/{id}/lists/{list_id}/comments/{sort}Get all list comments

Parameters

Name	In	Required	Type
`id`	path	yes	string
`list_id`	path	yes	string
`sort`	path	yes	string
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

POST/users/{id}/lists/{list_id}/itemsAdd items to personal list

Parameters

Name	In	Required	Type
`id`	path	yes	string
`list_id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`201`	201	—
`420`	420	—

GET/users/{id}/lists/{list_id}/items/movieGet movie list items

Parameters

Name	In	Required	Type
`id`	path	yes	string
`list_id`	path	yes	string
`extended`	query	no	—
`sort_by`	query	no	string
`sort_how`	query	no	string
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean
`page`	query	no	integer
`limit`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/lists/{list_id}/items/movie,showGet media list items

Parameters

Name	In	Required	Type
`id`	path	yes	string
`list_id`	path	yes	string
`extended`	query	no	—
`sort_by`	query	no	string
`sort_how`	query	no	string
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean
`page`	query	no	integer
`limit`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/lists/{list_id}/items/movie,show,season,episodeGet all list items

Parameters

Name	In	Required	Type
`id`	path	yes	string
`list_id`	path	yes	string
`extended`	query	no	—
`sort_by`	query	no	string
`sort_how`	query	no	string
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean
`page`	query	no	integer
`limit`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

POST/users/{id}/lists/{list_id}/items/removeRemove items from personal list

Parameters

Name	In	Required	Type
`id`	path	yes	string
`list_id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`200`	200	—

POST/users/{id}/lists/{list_id}/items/reorderReorder items on a list

Parameters

Name	In	Required	Type
`id`	path	yes	string
`list_id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/lists/{list_id}/items/showGet show list items

Parameters

Name	In	Required	Type
`id`	path	yes	string
`list_id`	path	yes	string
`extended`	query	no	—
`sort_by`	query	no	string
`sort_how`	query	no	string
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean
`page`	query	no	integer
`limit`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

PUT/users/{id}/lists/{list_id}/items/{list_item_id}Update a list item

Parameters

Name	In	Required	Type
`id`	path	yes	string
`list_id`	path	yes	string
`list_item_id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`204`	204	—

GET/users/{id}/lists/{list_id}/items/{type}/{sort_by}/{sort_how}Get items on a personal list

Parameters

Name	In	Required	Type
`id`	path	yes	string
`list_id`	path	yes	string
`type`	path	yes	string
`sort_by`	path	yes	string
`sort_how`	path	yes	string
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean
`page`	query	no	integer
`limit`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

POST/users/{id}/lists/{list_id}/likeLike a list

Parameters

Name	In	Required	Type
`id`	path	yes	string
`list_id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`204`	204	—

DELETE/users/{id}/lists/{list_id}/likeRemove like on a list

Parameters

Name	In	Required	Type
`id`	path	yes	string
`list_id`	path	yes	string

Responses

Status	Description	Schema
`204`	204	—

GET/users/{id}/lists/{list_id}/likesGet all users who liked a list

Parameters

Name	In	Required	Type
`id`	path	yes	string
`list_id`	path	yes	string
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

POST/users/{id}/lists/{list_id}/reorderReorder items on a list

Parameters

Name	In	Required	Type
`id`	path	yes	string
`list_id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`200`	200	—

POST/users/{id}/lists/{list_id}/reportReport a user's list

Parameters

Name	In	Required	Type
`id`	path	yes	string
`list_id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`201`	201	—
`400`	400	—
`409`	409	—

GET/users/{id}/mir/{year}/{month}Get month in review

Parameters

Name	In	Required	Type
`id`	path	yes	string
`year`	path	yes	integer
`month`	path	yes	integer
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/notes/{type}Get notes

Parameters

Name	In	Required	Type
`id`	path	yes	string
`type`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/ratings/Get all ratings

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/ratings/episodesGet episode ratings

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/ratings/moviesGet movie ratings

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/ratings/showsGet show ratings

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/ratings/{type}/{rating}Get ratings

Parameters

Name	In	Required	Type
`id`	path	yes	string
`type`	path	yes	string
`rating`	path	yes	string
`extended`	query	no	—
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

POST/users/{id}/reportReport a user

Parameters

Name	In	Required	Type
`id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`201`	201	—
`400`	400	—
`409`	409	—

GET/users/{id}/smart-listsGet a user's smart lists

Parameters

Name	In	Required	Type
`id`	path	yes	string

Responses

Status	Description	Schema
`200`	200	—

POST/users/{id}/smart-listsCreate smart list

Parameters

Name	In	Required	Type
`id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`201`	201	—

GET/users/{id}/smart-lists/{list_id}/Get smart list

Parameters

Name	In	Required	Type
`id`	path	yes	string
`list_id`	path	yes	string

Responses

Status	Description	Schema
`200`	200	—
`404`	404	—

PUT/users/{id}/smart-lists/{list_id}/Update smart list

Parameters

Name	In	Required	Type
`id`	path	yes	string
`list_id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`200`	200	—
`404`	404	—

DELETE/users/{id}/smart-lists/{list_id}/Delete a user's smart list

Parameters

Name	In	Required	Type
`id`	path	yes	string
`list_id`	path	yes	string

Responses

Status	Description	Schema
`204`	204	—
`404`	404	—

GET/users/{id}/statsGet stats

Parameters

Name	In	Required	Type
`id`	path	yes	string

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/watched/moviesGet watched movies

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	yes	string
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/watched/showsGet watched shows

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	yes	string
`page`	query	no	integer
`limit`	query	no	integer
`specials`	query	no	boolean
`season_numbers`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/watched/{type}Get watched

Parameters

Name	In	Required	Type
`id`	path	yes	string
`type`	path	yes	string
`extended`	query	no	—
`hidden`	query	no	boolean
`specials`	query	no	boolean
`count_specials`	query	no	boolean

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/watchingGet watching

Parameters

Name	In	Required	Type
`id`	path	yes	string
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—
`204`	204	—

GET/users/{id}/watchlist/comments/{sort}Get all watchlist comments

Parameters

Name	In	Required	Type
`id`	path	yes	string
`sort`	path	yes	string
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/watchlist/movie,show/{sort}Get media watchlist

Parameters

Name	In	Required	Type
`id`	path	yes	string
`sort`	path	yes	string
`extended`	query	no	—
`sort_by`	query	no	string
`sort_how`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`hide`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/watchlist/movies/{sort}Get movie watchlist

Parameters

Name	In	Required	Type
`id`	path	yes	string
`sort`	path	yes	string
`extended`	query	no	—
`sort_by`	query	no	string
`sort_how`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`hide`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/watchlist/shows/{sort}Get show watchlist

Parameters

Name	In	Required	Type
`id`	path	yes	string
`sort`	path	yes	string
`extended`	query	no	—
`sort_by`	query	no	string
`sort_how`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`hide`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/watchlist/{type}/{sort_by}/{sort_how}Get watchlist

Parameters

Name	In	Required	Type
`id`	path	yes	string
`type`	path	yes	string
`sort_by`	path	yes	string
`sort_how`	path	yes	string
`extended`	query	no	—
`sort_by`	query	no	string
`sort_how`	query	no	string
`page`	query	no	integer
`limit`	query	no	integer
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`hide`	query	no	string

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/yir/{year}Get year in review

Parameters

Name	In	Required	Type
`id`	path	yes	string
`year`	path	yes	integer
`extended`	query	no	—

Responses

Status	Description	Schema
`200`	200	—

GET/users/{id}/{type}/activitiesGet social activity

Parameters

Name	In	Required	Type
`id`	path	yes	string
`type`	path	yes	string
`extended`	query	no	—
`watchnow`	query	no	string
`genres`	query	no	string
`subgenres`	query	no	string
`years`	query	no	string
`ratings`	query	no	string
`start_date`	query	no	string
`end_date`	query	no	string
`runtimes`	query	no	string
`countries`	query	no	string
`certifications`	query	no	string
`ignore_watched`	query	no	boolean
`ignore_collected`	query	no	boolean
`ignore_watchlisted`	query	no	boolean
`page`	query	no	integer
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	200	—

watchnow2

GET/watchnow/sourcesGet watch now sources

Responses

Status	Description	Schema
`200`	200	—

GET/watchnow/sources/{countryCode}Get watch now sources by country

Parameters

Name	In	Required	Type
`countryCode`	path	yes	string

Responses

Status	Description	Schema
`200`	200	—

younify5

POST/younify/connectCreate a streaming connection

Request body

application/json

Responses

Status	Description	Schema
`200`	200	—
`400`	400	—
`422`	422	—

GET/younify/connectionsGet streaming connections

Responses

Status	Description	Schema
`200`	200	—

POST/younify/users/refresh/{service_id}Refresh a streaming service

Parameters

Name	In	Required	Type
`service_id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`204`	204	—

POST/younify/users/refresh/{service_id}/{all_data}Refresh a streaming service (full re-sync)

Parameters

Name	In	Required	Type
`service_id`	path	yes	string
`all_data`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`204`	204	—

DELETE/younify/users/services/{service_id}Unlink a streaming service

Parameters

Name	In	Required	Type
`service_id`	path	yes	string

Responses

Status	Description	Schema
`204`	204	—

Try it

Operation

API key

Developer reference

Base URLhttps://api.trakt.tv/

Rate limit

1000 GET requests per 5 minutes per user; POST/PUT/DELETE capped at 1 request per second per user, both authenticated and unauthenticated

Key endpoints

GET/shows/trending
GET/shows/{id}
GET/shows/{id}/seasons/{season}/episodes/{episode}
GET/movies/trending
GET/search/{type}

GreatAPIs Score

Embed this badge

Auth quickstart

Endpoints

Try it

Developer reference

People comparing Trakt also look at…

Bob's Burgers

An API of Ice And Fire

Dune

Harry Potter Charactes

IMDbOT

Lucifer Quotes