Begin signing in to Trakt.

Returns a short code and a URL. Open the URL, enter the code, then call finish_authentication. Only needed for the endpoints that act on an account: sync, users/me, checkin, scrobble, recommendations and lists you own.

Exchange an approved device code for a stored token.

Args: device_code: The device_code returned by start_authentication. wait_seconds: How long to keep polling while you approve in the browser. 0 checks once and reports whether approval is still pending, which is the better default for an interactive session.

Report whether an account is signed in and when the token expires.

Revoke the stored token and forget it.

Check into an item.

POST /checkin

Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Post a comment.

POST /comments/

Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Like a comment.

POST /comments/{id}/like

Args: id: The id/slug of the resource. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Add comment reaction.

POST /comments/{id}/reactions/{reaction_type}

Args: id: Path parameter. reaction_type: Path parameter. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Post a reply for a comment.

POST /comments/{id}/replies

Args: id: The id/slug of the resource. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Report a comment.

POST /comments/{id}/report

Args: id: The id/slug of the resource. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Report an episode.

POST /episodes/{id}/report

Args: id: The id/slug of the resource. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Like a list.

POST /lists/{id}/like

Args: id: The id/slug of the resource. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Report a list.

POST /lists/{id}/report

Args: id: The id/slug of the resource. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Refresh movie metadata.

POST /movies/{id}/refresh

Args: id: The id/slug of the resource. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects. images: Also queue a refresh of the resource images.

Refresh movie JustWatch links.

POST /movies/{id}/refresh/justwatch

Args: id: The id/slug of the resource. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Report a movie.

POST /movies/{id}/report

Args: id: The id/slug of the resource. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Add notes.

POST /notes

Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Generate new device codes.

POST /oauth/device/code

Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Poll for the access_token.

POST /oauth/device/token

Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Revoke an access_token.

POST /oauth/revoke

Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Exchange a token.

POST /oauth/token

Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Refresh person metadata.

POST /people/{id}/refresh

Args: id: The id/slug of the resource. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects. images: Also queue a refresh of the resource images.

Report a person.

POST /people/{id}/report

Args: id: The id/slug of the resource. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Pause watching in a media center.

POST /scrobble/pause

Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Start watching in a media center.

POST /scrobble/start

Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Stop or finish watching in a media center.

POST /scrobble/stop

Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Add recent search.

POST /search/recent/

Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Remove recent search.

POST /search/recent/remove

Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Report a season.

POST /seasons/{id}/report

Args: id: The id/slug of the resource. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Reset show progress.

POST /shows/{id}/progress/watched/reset

Args: id: The id/slug of the resource. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Refresh show metadata.

POST /shows/{id}/refresh

Args: id: The id/slug of the resource. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects. images: Also queue a refresh of the resource images.

Refresh show JustWatch links.

POST /shows/{id}/refresh/justwatch

Args: id: The id/slug of the resource. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Report a show.

POST /shows/{id}/report

Args: id: The id/slug of the resource. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Report an episode.

POST /shows/{id}/seasons/{season}/episodes/{episode}/report

Args: id: The id/slug of the resource. season: Season number episode: Episode number body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Report a season.

POST /shows/{id}/seasons/{season}/report

Args: id: The id/slug of the resource. season: Season number body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Add items to collection.

POST /sync/collection

Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Remove items from collection.

POST /sync/collection/remove

Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Add items to favorites.

POST /sync/favorites

Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Remove items from favorites.

POST /sync/favorites/remove

Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Reorder favorited items.

POST /sync/favorites/reorder

Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Add items to watched history.

POST /sync/history

Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Remove items from history.

POST /sync/history/remove

Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Add new ratings.

POST /sync/ratings

Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Remove ratings.

POST /sync/ratings/remove

Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Add items to watchlist.

POST /sync/watchlist

Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Remove items from watchlist.

POST /sync/watchlist/remove

Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Reorder watchlist items.

POST /sync/watchlist/reorder

Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Block this user.

POST /users/{id}/block

Args: id: The slug that identifies the user, or "me" for the authenticated user. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Follow this user.

POST /users/{id}/follow

Args: id: The slug that identifies the user, or "me" for the authenticated user. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Create personal list.

POST /users/{id}/lists

Args: id: Path parameter. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Add items to personal list.

POST /users/{id}/lists/{list_id}/items

Args: id: Path parameter. list_id: Path parameter. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Remove items from personal list.

POST /users/{id}/lists/{list_id}/items/remove

Args: id: Path parameter. list_id: Path parameter. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Reorder items on a list.

POST /users/{id}/lists/{list_id}/items/reorder

Args: id: The slug that identifies the user, or "me" for the authenticated user. list_id: Path parameter. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Like a list.

POST /users/{id}/lists/{list_id}/like

Args: id: The slug that identifies the user, or "me" for the authenticated user. list_id: Path parameter. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Reorder items on a list.

POST /users/{id}/lists/{list_id}/reorder

Args: id: The slug that identifies the user, or "me" for the authenticated user. list_id: Path parameter. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Report a user's list.

POST /users/{id}/lists/{list_id}/report

Args: id: The slug that identifies the user, or "me" for the authenticated user. list_id: Path parameter. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Reorder a user's lists.

POST /users/{id}/lists/reorder

Args: id: Path parameter. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Report a user.

POST /users/{id}/report

Args: id: The slug that identifies the user, or "me" for the authenticated user. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Create smart list.

POST /users/{id}/smart-lists

Args: id: Path parameter. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Add hidden items.

POST /users/hidden/{section}

Args: section: Path parameter. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Remove hidden items.

POST /users/hidden/{section}/remove

Args: section: Path parameter. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Remove hidden calendar items.

POST /users/hidden/calendar/remove

Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Remove hidden progress items.

POST /users/hidden/progress_watched/remove

Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Approve follow request.

POST /users/requests/{id}

Args: id: Path parameter. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects. extended: Extended information to include in the response.

Add saved filters.

POST /users/saved_filters

Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Connect Plex.

POST /users/settings/plex/connect

Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Sync Plex now.

POST /users/settings/plex/sync

Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Create a streaming connection.

POST /younify/connect

Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Refresh a streaming service.

POST /younify/users/refresh/{service_id}

Args: service_id: The streaming service id (e.g. netflix). body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Refresh a streaming service (full re-sync).

POST /younify/users/refresh/{service_id}/{all_data}

Args: service_id: The streaming service id to re-sync (e.g. netflix). all_data: Optional trailing segment that forces a full re-sync of all data rather than an incremental one. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Delete any active checkins.

DELETE /checkin

Delete a comment or reply.

DELETE /comments/{id}/

Args: id: The id/slug of the resource.

Remove like on a comment.

DELETE /comments/{id}/like

Args: id: The id/slug of the resource.

Remove comment reaction.

DELETE /comments/{id}/reactions/{reaction_type}

Args: id: Path parameter. reaction_type: Path parameter.

Remove like on a list.

DELETE /lists/{id}/like

Args: id: The id/slug of the resource.

Delete a note.

DELETE /notes/{id}

Args: id: The id/slug of the resource.

Hide a movie recommendation.

DELETE /recommendations/movies/{id}

Args: id: The id/slug of the resource.

Hide a show recommendation.

DELETE /recommendations/shows/{id}

Args: id: The id/slug of the resource.

Undo reset show progress.

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

Args: id: The id/slug of the resource.

Remove a playback item.

DELETE /sync/playback/{id}

Args: id: ID of the playback entry

Unblock this user.

DELETE /users/{id}/block

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

Unfollow this user.

DELETE /users/{id}/follow

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

Delete a user's personal list.

DELETE /users/{id}/lists/{list_id}/

Args: id: The slug that identifies the user, or "me" for the authenticated user. list_id: Path parameter.

Remove like on a list.

DELETE /users/{id}/lists/{list_id}/like

Args: id: The slug that identifies the user, or "me" for the authenticated user. list_id: Path parameter.

Delete a user's smart list.

DELETE /users/{id}/smart-lists/{list_id}/

Args: id: The slug that identifies the user, or "me" for the authenticated user. list_id: Path parameter.

Deny follow request.

DELETE /users/requests/{id}

Args: id: Path parameter.

Delete saved filter.

DELETE /users/saved_filters/{id}

Args: id: ID of the saved filter

Disconnect Plex.

DELETE /users/settings/plex/connect

Undo a data sync.

DELETE /users/syncs/{id}

Args: id: The numeric sync id, scoped to the authenticated user. A numeric segment hits a single sync; a non-numeric segment is the filtered list.

Unlink a streaming service.

DELETE /younify/users/services/{service_id}

Args: service_id: The streaming service id (e.g. netflix).

Get DVD releases.

GET /calendars/{target}/dvd/{start_date}/{days}

Args: target: Use "my" for all items that have been watched, collected, or watchlisted plus individual episodes on the watchlist. Use "all" for all items items airing during the specified period. start_date: The start date of the calendar. Must be formatted as "YYYY-MM-DD". days: The number of days to retrieve. extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date_query: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items.

Get media.

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

Args: target: Use "my" for all items that have been watched, collected, or watchlisted plus individual episodes on the watchlist. Use "all" for all items items airing during the specified period. start_date: The start date of the calendar. Must be formatted as "YYYY-MM-DD". days: The number of days to retrieve. extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date_query: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. type: Narrow the feed to a single media type. Omit to return both. group: Collapse same-show-same-day episodes into a single card (full_season / multiple_episodes). Omit for one entry per episode.

Get movies.

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

Args: target: Use "my" for all items that have been watched, collected, or watchlisted plus individual episodes on the watchlist. Use "all" for all items items airing during the specified period. start_date: The start date of the calendar. Must be formatted as "YYYY-MM-DD". days: The number of days to retrieve. extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date_query: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items.

Get shows.

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

Args: target: Use "my" for all items that have been watched, collected, or watchlisted plus individual episodes on the watchlist. Use "all" for all items items airing during the specified period. start_date: The start date of the calendar. Must be formatted as "YYYY-MM-DD". days: The number of days to retrieve. extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date_query: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items. group: Collapse same-show-same-day episodes into a single card (full_season / multiple_episodes). Omit for one entry per episode.

Get finales.

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

Args: target: Use "my" for all items that have been watched, collected, or watchlisted plus individual episodes on the watchlist. Use "all" for all items items airing during the specified period. start_date: The start date of the calendar. Must be formatted as "YYYY-MM-DD". days: The number of days to retrieve. extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date_query: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items.

Get new shows.

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

Args: target: Use "my" for all items that have been watched, collected, or watchlisted plus individual episodes on the watchlist. Use "all" for all items items airing during the specified period. start_date: The start date of the calendar. Must be formatted as "YYYY-MM-DD". days: The number of days to retrieve. extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date_query: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items.

Get season premieres.

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

Args: target: Use "my" for all items that have been watched, collected, or watchlisted plus individual episodes on the watchlist. Use "all" for all items items airing during the specified period. start_date: The start date of the calendar. Must be formatted as "YYYY-MM-DD". days: The number of days to retrieve. extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date_query: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items.

Get streaming releases.

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

Args: target: Use "my" for all items that have been watched, collected, or watchlisted plus individual episodes on the watchlist. Use "all" for all items items airing during the specified period. start_date: The start date of the calendar. Must be formatted as "YYYY-MM-DD". days: The number of days to retrieve. extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date_query: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items.

Get hot releases.

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

Args: start_date: The start date of the calendar. Must be formatted as "YYYY-MM-DD". days: The number of days to retrieve. extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date_query: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. type: Narrow the feed to a single media type. Omit to return both. group: Collapse same-show-same-day episodes into a single card (full_season / multiple_episodes). Omit for one entry per episode.

Get hot finales.

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

Args: start_date: The start date of the calendar. Must be formatted as "YYYY-MM-DD". days: The number of days to retrieve. extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date_query: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter.

Get hot new shows.

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

Args: start_date: The start date of the calendar. Must be formatted as "YYYY-MM-DD". days: The number of days to retrieve. extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date_query: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter.

Get hot premieres.

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

Args: start_date: The start date of the calendar. Must be formatted as "YYYY-MM-DD". days: The number of days to retrieve. extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date_query: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter.

Get certifications.

GET /certifications/{type}

Args: type: Certification media type.

Get a comment or reply.

GET /comments/{id}

Args: id: The id/slug of the resource.

Get the attached media item.

GET /comments/{id}/item

Args: id: The id/slug of the resource. extended: Extended information to include in the response.

Get all users who liked a comment.

GET /comments/{id}/likes

Args: id: The id/slug of the resource. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get comment reactions.

GET /comments/{id}/reactions/

Args: id: Path parameter. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page, can be a number or the value all

Get reaction summary.

GET /comments/{id}/reactions/summary

Args: id: Path parameter.

Get replies for a comment.

GET /comments/{id}/replies

Args: id: The id/slug of the resource. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get recently created comments.

GET /comments/recent/{comment_type}/{type}

Args: comment_type: Comment type filter. type: Media type filter. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page, can be a number or the value all include_replies: Include replies inline alongside top level comments.

Get trending comments.

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

Args: comment_type: Comment type filter. type: Media type filter. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page, can be a number or the value all include_replies: Include replies inline alongside top level comments.

Get recently updated comments.

GET /comments/updates/{comment_type}/{type}

Args: comment_type: Comment type filter. type: Media type filter. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page, can be a number or the value all include_replies: Include replies inline alongside top level comments.

Get countries.

GET /countries/{type}

Args: type: Media type to return countries for.

Get episode watch now sources.

GET /episodes/{id}/watchnow/{country}

Args: id: The Trakt ID of the resource to get the watch now sources of. country: 2 character country code. links: Query parameter. extended: Extended information to include in the response.

Get genres.

GET /genres/{type}

Args: type: Media type to return genres for. extended: Extended information to include in the response.

Get languages.

GET /languages/{type}

Args: type: Media type to return languages for.

Get list.

GET /lists/{id}

Args: id: The id/slug of the resource. extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items.

Get all list comments.

GET /lists/{id}/comments/{sort}

Args: id: The id/slug of the resource. sort: Comment sort option. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page, can be a number or the value all

Get items on a list.

GET /lists/{id}/items/{type}/{sort_by}/{sort_how}

Args: id: The id/slug of the resource. type: List item type filter. sort_by: Sort by a specific property. sort_how: Sort direction. extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items. page: The page number to retrieve limit: The number of items per page, can be a number or the value all

Get movie list items.

GET /lists/{id}/items/movie

Args: id: The id/slug of the resource. extended: Extended information to include in the response. sort_by: The field to sort by sort_how: The direction to sort in watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items. page: The page number to retrieve limit: The number of items per page, can be a number or the value all

Get media list items.

GET /lists/{id}/items/movie,show

Args: id: The id/slug of the resource. extended: Extended information to include in the response. sort_by: The field to sort by sort_how: The direction to sort in watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items. page: The page number to retrieve limit: The number of items per page, can be a number or the value all

Get all list items.

GET /lists/{id}/items/movie,show,episode,season

Args: id: The id/slug of the resource. extended: Extended information to include in the response. sort_by: The field to sort by sort_how: The direction to sort in watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items. page: The page number to retrieve limit: The number of items per page, can be a number or the value all

Get show list items.

GET /lists/{id}/items/show

Args: id: The id/slug of the resource. extended: Extended information to include in the response. sort_by: The field to sort by sort_how: The direction to sort in watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items. page: The page number to retrieve limit: The number of items per page, can be a number or the value all

Get all users who liked a list.

GET /lists/{id}/likes

Args: id: The id/slug of the resource. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get popular lists.

GET /lists/popular/{type}

Args: type: List type filter. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter.

Get trending lists.

GET /lists/trending/{type}

Args: type: List type filter. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter.

Get a movie.

GET /movies/{id}

Args: id: The id/slug of the resource. extended: Extended information to include in the response.

Get all movie aliases.

GET /movies/{id}/aliases

Args: id: The id/slug of the resource.

Get all movie comments.

GET /movies/{id}/comments/{sort}

Args: id: The id/slug of the resource. sort: Path parameter. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page, can be a number or the value all language: Filter comments to a 2 character language code

Get lists containing this movie.

GET /movies/{id}/lists/{type}/{sort}

Args: id: The id/slug of the resource. sort: Path parameter. type: Path parameter. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get all people for a movie.

GET /movies/{id}/people

Args: id: The id/slug of the resource. extended: Extended information to include in the response.

Get movie ratings.

GET /movies/{id}/ratings

Args: id: The id/slug of the resource. extended: Use all to include ratings from supported external sources.

Get related movies.

GET /movies/{id}/related

Args: id: The id/slug of the resource. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get all movie releases.

GET /movies/{id}/releases/{country}

Args: id: The id/slug of the resource. country: 2 character country code.

Get movie sentiments.

GET /movies/{id}/sentiments

Args: id: The id/slug of the resource.

Get movie stats.

GET /movies/{id}/stats

Args: id: The id/slug of the resource.

Get movie studios.

GET /movies/{id}/studios

Args: id: The id/slug of the resource.

Get all movie translations.

GET /movies/{id}/translations

Args: id: The id/slug of the resource. language: Filter translations to a 2 character language code

Get all videos.

GET /movies/{id}/videos

Args: id: The id/slug of the resource.

Get users watching right now.

GET /movies/{id}/watching

Args: id: The id/slug of the resource. extended: Extended information to include in the response.

Get movie watch now sources.

GET /movies/{id}/watchnow/{country}

Args: id: The id/slug of the resource. country: 2 character country code. links: Query parameter. extended: Extended information to include in the response.

Get movie JustWatch links.

GET /movies/{id}/watchnow/justwatch_links/{country}

Args: country: Path parameter. id: The id/slug of the resource.

Get the most collected movies.

GET /movies/collected/{period}

Args: period: Path parameter. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items.

Get the most favorited movies.

GET /movies/favorited/{period}

Args: period: Path parameter. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items.

Get the most played movies.

GET /movies/played/{period}

Args: period: Path parameter. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items.

Get streaming movies.

GET /movies/streaming/{period}

Args: period: Path parameter. extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items.

Get recently updated movies.

GET /movies/updates/{start_date}

Args: start_date: UTC date to start checking for updates. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get recently updated movie Trakt IDs.

GET /movies/updates/id/{start_date}

Args: start_date: UTC date to start checking for updates. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get the most watched movies.

GET /movies/watched/{period}

Args: period: Path parameter. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items.

Get a note.

GET /notes/{id}

Args: id: The id/slug of the resource.

Get the attached item.

GET /notes/{id}/item

Args: id: The id/slug of the resource.

Get a single person.

GET /people/{id}/

Args: id: The id/slug of the resource. extended: Extended information to include in the response.

Get lists containing this person.

GET /people/{id}/lists/{type}/{sort}

Args: id: The id/slug of the resource. sort: Path parameter. type: Path parameter. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get movie credits.

GET /people/{id}/movies

Args: id: The id/slug of the resource. extended: Extended information to include in the response.

Get show credits.

GET /people/{id}/shows

Args: id: The id/slug of the resource. extended: Extended information to include in the response.

Get recently updated people.

GET /people/updates/{start_date}

Args: start_date: UTC date to start checking for updates. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get recently updated people Trakt IDs.

GET /people/updates/id/{start_date}

Args: start_date: UTC date to start checking for updates. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get ID lookup results.

GET /search/{id_type}/{id}

Args: id_type: External ID type to look up. id: External ID value. type: Optional media type filter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. extended: Extended information to include in the response.

Get text query results.

GET /search/{type}

Args: type: Specify the type of results by sending a single value or a comma delimited string for multiple types. query: The search query to search all text based fields. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. extended: Extended information to include in the response.

Get exact text query results.

GET /search/{type}/exact

Args: type: Specify the type of results by sending a single value or a comma delimited string for multiple types. query: The search query to search all text based fields. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. extended: Extended information to include in the response.

Get trending search results.

GET /search/recent_by_id/global/{type}

Args: type: Specify the type of results by sending a single value or a comma delimited string for multiple types. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. query: The search query to search all text based fields. extended: Extended information to include in the response.

Get a single show.

GET /shows/{id}

Args: id: The id/slug of the resource. extended: Extended information to include in the response.

Get all show aliases.

GET /shows/{id}/aliases

Args: id: The id/slug of the resource.

Get all show certifications.

GET /shows/{id}/certifications

Args: id: The id/slug of the resource.

Get all show comments.

GET /shows/{id}/comments/{sort}

Args: id: The id/slug of the resource. sort: Path parameter. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page, can be a number or the value all language: Filter comments to a 2 character language code

Get last episode.

GET /shows/{id}/last_episode

Args: id: The id/slug of the resource. extended: Extended information to include in the response.

Get lists containing this show.

GET /shows/{id}/lists/{type}/{sort}

Args: id: The id/slug of the resource. sort: Path parameter. type: Path parameter. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get next episode.

GET /shows/{id}/next_episode

Args: id: The id/slug of the resource. extended: Extended information to include in the response.

Get all people for a show.

GET /shows/{id}/people

Args: id: The id/slug of the resource. extended: Extended information to include in the response.

Get show collection progress.

GET /shows/{id}/progress/collection

Args: id: The id/slug of the resource. extended: Extended information to include in the response. hidden: Whether to include any hidden seasons specials: Whether to include special seasons as season 0. count_specials: Whether to count specials in the overall stats (only applies if specials are included). include_stats: Whether to include stats in the response

Get show watched progress.

GET /shows/{id}/progress/watched

Args: id: The id/slug of the resource. extended: Extended information to include in the response. hidden: Whether to include any hidden seasons specials: Whether to include special seasons as season 0. count_specials: Whether to count specials in the overall stats (only applies if specials are included). include_stats: Whether to include stats in the response

Get show ratings.

GET /shows/{id}/ratings

Args: id: The id/slug of the resource. extended: Use all to include ratings from supported external sources.

Get related shows.

GET /shows/{id}/related

Args: id: The id/slug of the resource. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get all seasons for a show.

GET /shows/{id}/seasons

Args: id: The id/slug of the resource. extended: Extended information to include in the response.

Get all episodes for a single season.

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

Args: id: The id/slug of the resource. season: Season number extended: Extended information to include in the response.

Get all season comments.

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

Args: id: The id/slug of the resource. season: Season number sort: Path parameter. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page, can be a number or the value all language: Filter comments to a 2 character language code

Get a single episode for a show.

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

Args: id: The id/slug of the resource. season: Season number episode: Episode number extended: Extended information to include in the response.

Get all episode comments.

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

Args: id: The id/slug of the resource. season: Season number episode: Episode number sort: Path parameter. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page, can be a number or the value all language: Filter comments to a 2 character language code

Get lists containing this episode.

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

Args: id: The id/slug of the resource. season: Season number episode: Episode number sort: Path parameter. type: Path parameter. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get all people for an episode.

GET /shows/{id}/seasons/{season}/episodes/{episode}/people

Args: id: The id/slug of the resource. season: Season number episode: Episode number extended: Extended information to include in the response.

Get episode ratings.

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

Args: id: The id/slug of the resource. season: Season number episode: Episode number extended: Use all to include ratings from supported external sources.

Get episode stats.

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

Args: id: The id/slug of the resource. season: Season number episode: Episode number

Get all episode translations.

GET /shows/{id}/seasons/{season}/episodes/{episode}/translations

Args: id: The id/slug of the resource. season: Season number episode: Episode number language: Filter translations to a 2 character language code

Get all videos.

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

Args: id: The id/slug of the resource. season: Season number episode: Episode number

Get users watching right now.

GET /shows/{id}/seasons/{season}/episodes/{episode}/watching

Args: id: The id/slug of the resource. season: Season number episode: Episode number extended: Extended information to include in the response.

Get episode watch now sources.

GET /shows/{id}/seasons/{season}/episodes/{episode}/watchnow/{country}

Args: id: The id/slug of the resource. country: 2 character country code. season: Season number episode: Episode number links: Query parameter. extended: Extended information to include in the response.

Get single seasons for a show.

GET /shows/{id}/seasons/{season}/info

Args: id: The id/slug of the resource. season: Season number extended: Extended information to include in the response.

Get lists containing this season.

GET /shows/{id}/seasons/{season}/lists/{type}/{sort}

Args: id: The id/slug of the resource. season: Season number sort: Path parameter. type: Path parameter. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get all people for a season.

GET /shows/{id}/seasons/{season}/people

Args: id: The id/slug of the resource. season: Season number extended: Extended information to include in the response.

Get season ratings.

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

Args: id: The id/slug of the resource. season: Season number extended: Use all to include ratings from supported external sources.

Get season stats.

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

Args: id: The id/slug of the resource. season: Season number

Get all season translations.

GET /shows/{id}/seasons/{season}/translations

Args: id: The id/slug of the resource. season: Season number language: Filter translations to a 2 character language code

Get all videos.

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

Args: id: The id/slug of the resource. season: Season number

Get users watching right now.

GET /shows/{id}/seasons/{season}/watching

Args: id: The id/slug of the resource. season: Season number extended: Extended information to include in the response.

Get season JustWatch links.

GET /shows/{id}/seasons/{season}/watchnow/justwatch_links/{country}

Args: season: Path parameter. country: Path parameter. id: The id/slug of the resource.

Get show sentiments.

GET /shows/{id}/sentiments

Args: id: The id/slug of the resource.

Get show stats.

GET /shows/{id}/stats

Args: id: The id/slug of the resource.

Get show studios.

GET /shows/{id}/studios

Args: id: The id/slug of the resource.

Get all show translations.

GET /shows/{id}/translations

Args: id: The id/slug of the resource. language: Filter translations to a 2 character language code

Get all videos.

GET /shows/{id}/videos

Args: id: The id/slug of the resource.

Get users watching right now.

GET /shows/{id}/watching

Args: id: The id/slug of the resource. extended: Extended information to include in the response.

Get show watch now sources.

GET /shows/{id}/watchnow/{country}

Args: id: The id/slug of the resource. country: 2 character country code. links: Query parameter. extended: Extended information to include in the response.

Get show JustWatch links.

GET /shows/{id}/watchnow/justwatch_links/{country}

Args: country: Path parameter. id: The id/slug of the resource.

Get the most collected shows.

GET /shows/collected/{period}

Args: period: Path parameter. extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items.

Get the most favorited shows.

GET /shows/favorited/{period}

Args: period: Path parameter. extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items.

Get the most played shows.

GET /shows/played/{period}

Args: period: Path parameter. extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items.

Get streaming shows.

GET /shows/streaming/{period}

Args: period: Path parameter. extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items.

Get recently updated shows.

GET /shows/updates/{start_date}

Args: start_date: UTC date to start checking for updates. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get recently updated show Trakt IDs.

GET /shows/updates/id/{start_date}

Args: start_date: UTC date to start checking for updates. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get the most watched shows.

GET /shows/watched/{period}

Args: period: Path parameter. extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items.

Get smart list.

GET /smart-lists/{list_id}

Args: list_id: Path parameter.

Get smart list items.

GET /smart-lists/{list_id}/items

Args: list_id: Path parameter. extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. ignore_watched: Ignore watched items. ignore_watchlisted: Ignore watchlisted items. page: The page number to retrieve limit: The number of items per page, can be a number or the value all

Get collection.

GET /sync/collection/{type}

Args: type: Sync media type filter. extended: Extended information to include in the response. available_on: Query parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get favorites.

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

Args: type: Sync media type filter. sort_by: Sort by a specific property. sort_how: Sort direction. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get watched history.

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

Args: type: Sync media type filter. id: Trakt ID for a specific item. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. start_at: Start date for the range. Must be formatted as "YYYY-MM-DD". end_at: End date for the range. Must be formatted as "YYYY-MM-DD".

Get playback progress.

GET /sync/playback/{type}

Args: type: Sync media type filter. extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. start_at: Start date for the range. Must be formatted as "YYYY-MM-DD". end_at: End date for the range. Must be formatted as "YYYY-MM-DD".

Get ratings.

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

Args: type: Sync media type filter. rating: Rating filter from 1 to 10. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get watched.

GET /sync/watched/{type}

Args: type: Sync media type filter. extended: Extended information to include in the response.

Get watchlist.

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

Args: type: Sync media type filter. sort_by: Sort by a specific property. sort_how: Sort direction. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get user profile.

GET /users/{id}/

Args: id: The slug that identifies the user, or "me" for the authenticated user. extended: Extended information to include in the response.

Get social activity.

GET /users/{id}/{type}/activities

Args: id: The slug that identifies the user, or "me" for the authenticated user. type: Path parameter. extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get collection.

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

Args: id: The slug that identifies the user, or "me" for the authenticated user. type: User media type filter. extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get comments.

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

Args: id: The slug that identifies the user, or "me" for the authenticated user. comment_type: Path parameter. type: Path parameter. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. include_replies: Query parameter.

Get favorites.

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

Args: id: The slug that identifies the user, or "me" for the authenticated user. type: Favorites media type filter. sort_by: Sort by a specific property. sort_how: Sort direction. extended: Extended information to include in the response. sort_by_query: The field to sort by sort_how_query: The direction to sort in page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get all favorites comments.

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

Args: id: The slug that identifies the user, or "me" for the authenticated user. sort: Path parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get favorite media.

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

Args: id: The slug that identifies the user, or "me" for the authenticated user. sort: Path parameter. extended: Extended information to include in the response. sort_by: The field to sort by sort_how: The direction to sort in page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get favorite movies.

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

Args: id: The slug that identifies the user, or "me" for the authenticated user. sort: Path parameter. extended: Extended information to include in the response. sort_by: The field to sort by sort_how: The direction to sort in page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get favorite shows.

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

Args: id: The slug that identifies the user, or "me" for the authenticated user. sort: Path parameter. extended: Extended information to include in the response. sort_by: The field to sort by sort_how: The direction to sort in page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get followers.

GET /users/{id}/followers

Args: id: The slug that identifies the user, or "me" for the authenticated user. extended: Extended information to include in the response.

Get following.

GET /users/{id}/following

Args: id: The slug that identifies the user, or "me" for the authenticated user. extended: Extended information to include in the response.

Get friends.

GET /users/{id}/friends

Args: id: The slug that identifies the user, or "me" for the authenticated user. extended: Extended information to include in the response.

Get watched history.

GET /users/{id}/history/

Args: id: The slug that identifies the user, or "me" for the authenticated user. extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. start_at: Start date for the range. Must be formatted as "YYYY-MM-DD". end_at: End date for the range. Must be formatted as "YYYY-MM-DD". page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get watched history.

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

Args: id: The slug that identifies the user, or "me" for the authenticated user. item_id: Path parameter. type: History media type filter. extended: Extended information to include in the response. start_at: Start date for the range. Must be formatted as "YYYY-MM-DD". end_at: End date for the range. Must be formatted as "YYYY-MM-DD". page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get episode watched history.

GET /users/{id}/history/episodes

Args: id: The slug that identifies the user, or "me" for the authenticated user. extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. start_at: Start date for the range. Must be formatted as "YYYY-MM-DD". end_at: End date for the range. Must be formatted as "YYYY-MM-DD". page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get history for an episode.

GET /users/{id}/history/episodes/{item_id}

Args: id: The slug that identifies the user, or "me" for the authenticated user. item_id: Path parameter. extended: Extended information to include in the response. start_at: Start date for the range. Must be formatted as "YYYY-MM-DD". end_at: End date for the range. Must be formatted as "YYYY-MM-DD". page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get movie watched history.

GET /users/{id}/history/movies

Args: id: The slug that identifies the user, or "me" for the authenticated user. extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. start_at: Start date for the range. Must be formatted as "YYYY-MM-DD". end_at: End date for the range. Must be formatted as "YYYY-MM-DD". page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get history for a movie.

GET /users/{id}/history/movies/{item_id}

Args: id: The slug that identifies the user, or "me" for the authenticated user. item_id: Path parameter. extended: Extended information to include in the response. start_at: Start date for the range. Must be formatted as "YYYY-MM-DD". end_at: End date for the range. Must be formatted as "YYYY-MM-DD". page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get show watched history.

GET /users/{id}/history/shows

Args: id: The slug that identifies the user, or "me" for the authenticated user. extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. start_at: Start date for the range. Must be formatted as "YYYY-MM-DD". end_at: End date for the range. Must be formatted as "YYYY-MM-DD". page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get history for a show.

GET /users/{id}/history/shows/{item_id}

Args: id: The slug that identifies the user, or "me" for the authenticated user. item_id: Path parameter. extended: Extended information to include in the response. start_at: Start date for the range. Must be formatted as "YYYY-MM-DD". end_at: End date for the range. Must be formatted as "YYYY-MM-DD". page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get likes.

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

Args: id: The slug that identifies the user, or "me" for the authenticated user. type: User media type filter. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page, can be a number or the value all

Get a user's personal lists.

GET /users/{id}/lists

Args: id: The slug that identifies the user, or "me" for the authenticated user. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get personal list.

GET /users/{id}/lists/{list_id}/

Args: id: The slug that identifies the user, or "me" for the authenticated user. list_id: Path parameter. extended: Extended information to include in the response.

Get all list comments.

GET /users/{id}/lists/{list_id}/comments/{sort}

Args: id: The slug that identifies the user, or "me" for the authenticated user. list_id: Path parameter. sort: Path parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get items on a personal list.

GET /users/{id}/lists/{list_id}/items/{type}/{sort_by}/{sort_how}

Args: id: The slug that identifies the user, or "me" for the authenticated user. list_id: Path parameter. type: List item type filter. sort_by: Sort by a specific property. sort_how: Sort direction. extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items. page: The page number to retrieve limit: The number of items per page, can be a number or the value all

Get movie list items.

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

Args: id: The slug that identifies the user, or "me" for the authenticated user. list_id: Path parameter. extended: Extended information to include in the response. sort_by: The field to sort by sort_how: The direction to sort in watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items. page: The page number to retrieve limit: The number of items per page, can be a number or the value all

Get media list items.

GET /users/{id}/lists/{list_id}/items/movie,show

Args: id: The slug that identifies the user, or "me" for the authenticated user. list_id: Path parameter. extended: Extended information to include in the response. sort_by: The field to sort by sort_how: The direction to sort in watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items. page: The page number to retrieve limit: The number of items per page, can be a number or the value all

Get all list items.

GET /users/{id}/lists/{list_id}/items/movie,show,season,episode

Args: id: The slug that identifies the user, or "me" for the authenticated user. list_id: Path parameter. extended: Extended information to include in the response. sort_by: The field to sort by sort_how: The direction to sort in watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items. page: The page number to retrieve limit: The number of items per page, can be a number or the value all

Get show list items.

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

Args: id: The slug that identifies the user, or "me" for the authenticated user. list_id: Path parameter. extended: Extended information to include in the response. sort_by: The field to sort by sort_how: The direction to sort in watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items. page: The page number to retrieve limit: The number of items per page, can be a number or the value all

Get all users who liked a list.

GET /users/{id}/lists/{list_id}/likes

Args: id: The slug that identifies the user, or "me" for the authenticated user. list_id: Path parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get all lists a user can collaborate on.

GET /users/{id}/lists/collaborations

Args: id: The slug that identifies the user, or "me" for the authenticated user. extended: Extended information to include in the response.

Get month in review.

GET /users/{id}/mir/{year}/{month}

Args: id: The slug that identifies the user, or "me" for the authenticated user. year: Path parameter. month: Path parameter. extended: Extended information to include in the response.

Get notes.

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

Args: id: The slug that identifies the user, or "me" for the authenticated user. type: User media type filter. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get all ratings.

GET /users/{id}/ratings/

Args: id: The slug that identifies the user, or "me" for the authenticated user. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get ratings.

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

Args: id: The slug that identifies the user, or "me" for the authenticated user. type: Rated media type filter. rating: Rating filter from 1 to 10. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get episode ratings.

GET /users/{id}/ratings/episodes

Args: id: The slug that identifies the user, or "me" for the authenticated user. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get movie ratings.

GET /users/{id}/ratings/movies

Args: id: The slug that identifies the user, or "me" for the authenticated user. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get show ratings.

GET /users/{id}/ratings/shows

Args: id: The slug that identifies the user, or "me" for the authenticated user. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get a user's smart lists.

GET /users/{id}/smart-lists

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

Get smart list.

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

Args: id: The slug that identifies the user, or "me" for the authenticated user. list_id: Path parameter.

Get stats.

GET /users/{id}/stats

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

Get watched.

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

Args: id: The slug that identifies the user, or "me" for the authenticated user. type: Watched media type filter. extended: Extended information to include in the response. hidden: Whether to include any hidden seasons specials: Whether to include special seasons as season 0. count_specials: Whether to count specials in the overall stats (only applies if specials are included).

Get watched movies.

GET /users/{id}/watched/movies

Args: id: The slug that identifies the user, or "me" for the authenticated user. extended: Query parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get watched shows.

GET /users/{id}/watched/shows

Args: id: The slug that identifies the user, or "me" for the authenticated user. extended: Query parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. specials: Whether to include special seasons as season 0. season_numbers: Query parameter.

Get watching.

GET /users/{id}/watching

Args: id: The slug that identifies the user, or "me" for the authenticated user. extended: Extended information to include in the response.

Get watchlist.

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

Args: id: The slug that identifies the user, or "me" for the authenticated user. type: Watchlist media type filter. sort_by: Sort by a specific property. sort_how: Sort direction. extended: Extended information to include in the response. sort_by_query: The field to sort by sort_how_query: The direction to sort in page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. hide: Query parameter.

Get all watchlist comments.

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

Args: id: The slug that identifies the user, or "me" for the authenticated user. sort: Path parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get media watchlist.

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

Args: id: The slug that identifies the user, or "me" for the authenticated user. sort: Path parameter. extended: Extended information to include in the response. sort_by: The field to sort by sort_how: The direction to sort in page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. hide: Query parameter.

Get movie watchlist.

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

Args: id: The slug that identifies the user, or "me" for the authenticated user. sort: Path parameter. extended: Extended information to include in the response. sort_by: The field to sort by sort_how: The direction to sort in page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. hide: Query parameter.

Get show watchlist.

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

Args: id: The slug that identifies the user, or "me" for the authenticated user. sort: Path parameter. extended: Extended information to include in the response. sort_by: The field to sort by sort_how: The direction to sort in page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. hide: Query parameter.

Get year in review.

GET /users/{id}/yir/{year}

Args: id: The slug that identifies the user, or "me" for the authenticated user. year: Path parameter. extended: Extended information to include in the response.

Get hidden items.

GET /users/hidden/{section}

Args: section: Path parameter. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. type: Hidden item type filter.

Get saved filters.

GET /users/saved_filters/{section}

Args: section: Path parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get Plex server accounts and libraries.

GET /users/settings/plex/servers/{server_id}

Args: server_id: The Plex server machine identifier.

Get a data sync.

GET /users/syncs/{id}

Args: id: The numeric sync id, scoped to the authenticated user. A numeric segment hits a single sync; a non-numeric segment is the filtered list.

Get paused sync items.

GET /users/syncs/{id}/paused

Args: id: The numeric sync id, scoped to the authenticated user. A numeric segment hits a single sync; a non-numeric segment is the filtered list. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get skipped sync items.

GET /users/syncs/{id}/skipped

Args: id: The numeric sync id, scoped to the authenticated user. A numeric segment hits a single sync; a non-numeric segment is the filtered list. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get data syncs by type.

GET /users/syncs/{type}

Args: type: Filter syncs by the app that created them. An unknown type returns 404 rather than silently returning everything. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get watch now sources by country.

GET /watchnow/sources/{countryCode}

Args: country_code: Path parameter.

Get movie certifications.

GET /certifications/movies

Get show certifications.

GET /certifications/shows

Get popular lists.

GET /lists/popular

Args: extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter.

Get trending lists.

GET /lists/trending

Args: extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter.

Get anticipated media.

GET /media/anticipated

Args: extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items.

Get popular media.

GET /media/popular

Args: extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items.

Get trending media.

GET /media/trending

Args: extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items.

Get the most anticipated movies.

GET /movies/anticipated

Args: extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items.

Get the weekend box office.

GET /movies/boxoffice

Args: extended: Extended information to include in the response.

Get hot movies.

GET /movies/hot

Args: extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items.

Get popular movies.

GET /movies/popular

Args: extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items.

Get trending movies.

GET /movies/trending

Args: extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items.

Get networks.

GET /networks

Authorize Application.

GET /oauth/authorize

Args: response_type: Query parameter. client_id: Query parameter. redirect_uri: Query parameter. state: Query parameter.

Get movie recommendations.

GET /recommendations/movies/

Args: extended: Extended information to include in the response. limit: Limit the number of results. watch_window: The watch window in days for the recommendations. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter.

Get show recommendations.

GET /recommendations/shows/

Args: extended: Extended information to include in the response. limit: Limit the number of results. watch_window: The watch window in days for the recommendations. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter.

Get the most anticipated shows.

GET /shows/anticipated

Args: extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items.

Get hot shows.

GET /shows/hot

Args: extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items.

Get popular shows.

GET /shows/popular

Args: extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items.

Get trending shows.

GET /shows/trending

Args: extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items.

Get social movie recommendations.

GET /social_recommendations/movies/

Args: extended: Extended information to include in the response. limit: Limit the number of results. watch_window: The watch window in days for the recommendations. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items.

Get social show recommendations.

GET /social_recommendations/shows/

Args: extended: Extended information to include in the response. limit: Limit the number of results. watch_window: The watch window in days for the recommendations. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items.

Get episode collection.

GET /sync/collection/episodes

Args: extended: Extended information to include in the response. available_on: Query parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get media collection.

GET /sync/collection/media

Args: extended: Extended information to include in the response. available_on: Query parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get minimal episode collection.

GET /sync/collection/minimal/episodes

Args: available_on: Query parameter.

Get minimal movie collection.

GET /sync/collection/minimal/movies

Args: available_on: Query parameter.

Get minimal show collection.

GET /sync/collection/minimal/shows

Args: available_on: Query parameter.

Get movie collection.

GET /sync/collection/movies

Args: extended: Extended information to include in the response. available_on: Query parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get show collection.

GET /sync/collection/shows

Args: extended: Extended information to include in the response. available_on: Query parameter.

Get last activity.

GET /sync/last_activities

Get movie playback progress.

GET /sync/playback/movies

Args: extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. start_at: Start date for the range. Must be formatted as "YYYY-MM-DD". end_at: End date for the range. Must be formatted as "YYYY-MM-DD".

Get up next.

GET /sync/progress/up_next

Args: extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. sort_by: The field to sort by sort_how: The direction to sort in include_stats: Whether to include stats in the response lifetime_stats: When true, progress.completed and progress.stats reflect lifetime totals across all watches of the show. When false (default), they reflect the current watching session — i.e. counters reset by /shows/:id/progress/watched/reset.

Get up next nitro.

GET /sync/progress/up_next_nitro

Args: page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. sort_by: The field to sort by sort_how: The direction to sort in intent: To get shows a user is just starting, continuing, completed, or all shows.

Get watched progress.

GET /sync/progress/watched

Args: extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. sort_by: The field to sort by sort_how: The direction to sort in lifetime_stats: When true, progress.completed and progress.stats reflect lifetime totals across all watches of the show. When false (default), they reflect the current watching session — i.e. counters reset by /shows/:id/progress/watched/reset. hide_completed: Query parameter. hide_not_completed: Query parameter. only_rewatching: When true, restrict the list to shows the user is currently rewatching (i.e. those with an active progress.reset_at).

Get team members.

GET /team/

Args: extended: Extended information to include in the response.

Get blocked users.

GET /users/blocked

Get dropped shows.

GET /users/hidden/dropped

Args: extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get hidden progress items.

GET /users/hidden/progress_watched

Args: extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. type: Query parameter.

Get comment reactions.

GET /users/reactions/comments

Args: extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page, can be a number or the value all

Get follow requests.

GET /users/requests/

Args: extended: Extended information to include in the response.

Get pending following requests.

GET /users/requests/following

Args: extended: Extended information to include in the response.

Retrieve settings.

GET /users/settings

Args: extended: Extended information to include in the response.

Get Plex settings.

GET /users/settings/plex/

Get Plex servers.

GET /users/settings/plex/servers

Get data syncs.

GET /users/syncs/

Args: page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected.

Get watch now sources.

GET /watchnow/sources

Get streaming connections.

GET /younify/connections

Update a comment or reply.

PUT /comments/{id}/

Args: id: The id/slug of the resource. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Update a note.

PUT /notes/{id}

Args: id: The id/slug of the resource. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Update favorites.

PUT /sync/favorites

Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Update a favorite item.

PUT /sync/favorites/{list_item_id}

Args: list_item_id: List item ID. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Update watchlist.

PUT /sync/watchlist

Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Update a watchlist item.

PUT /sync/watchlist/{list_item_id}

Args: list_item_id: List item ID. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Update avatar.

PUT /users/avatar

Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Update personal list.

PUT /users/{id}/lists/{list_id}/

Args: id: The slug that identifies the user, or "me" for the authenticated user. list_id: Path parameter. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Update a list item.

PUT /users/{id}/lists/{list_id}/items/{list_item_id}

Args: id: The slug that identifies the user, or "me" for the authenticated user. list_id: Path parameter. list_item_id: List item ID. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Update smart list.

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

Args: id: The slug that identifies the user, or "me" for the authenticated user. list_id: Path parameter. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Update cover image.

PUT /users/set_cover

Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Update settings.

PUT /users/settings

Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.

Update Plex settings.

PUT /users/settings/plex/

Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.