Skip to main content
Glama
Trakt MCP server

Trakt MCP server

by rollecode

Trakt MCP server

Version Python Trakt Coverage

Read and write Trakt from Claude.ai and Claude Code. All 334 endpoints are tools, generated from Trakt's own contract package. Not a curated subset: shows, movies, seasons, episodes, people, comments, lists, calendars, scrobbling, check-ins and everything under a signed-in account.

WARNING

Using this server with a paid AI service costs money. Tool definitions and results are billed as input tokens, and an agent can call tools repeatedly on its own. You are responsible for every charge, so set spending limits with your provider. The author accepts no liability for any costs. SeeDISCLAIMER.md.

Why not the other options

Server

Tools

Coverage

wwiens/trakt_mcpserver

79

24 %

niavasha/plex-mcp-server (trakt part)

9

3 %

This one

334

100 %

The existing servers cover trending, popular, a user's history and a check-in. Nothing else exposes notes, smart lists, favorites, hidden items, the recommendation feed, JustWatch sources, reactions, the scrobbler, calendars beyond the basics, or most of the sync surface that makes Trakt worth scripting.

Related MCP server: Plex MCP server

How it stays complete

Trakt publishes no OpenAPI file, but it maintains trakt/api-help, a typed contract package covering every endpoint, with a task that renders it to OpenAPI. scripts/fetch_spec.sh runs that task and slims the 5 MB result down to what the generator reads:

scripts/fetch_spec.sh
python scripts/generate_tools.py openapi.json src/trakt_mcp/tools.py

This uses Trakt's own generator rather than parsing their contracts independently, so the document here is the one their tooling produces. A test then compares every generated call against every operation in it, in both directions.

Tool names

Verb first, derived from the method and path:

Pattern

Meaning

Example

list_*

Read a collection

list_movies_trending

get_*

Read one record

get_shows_by_id

create_*

POST

create_checkin, create_sync_history

update_*

PUT

update_users_by_id_lists_by_list_id

delete_*

DELETE

delete_sync_watchlist_remove

334 tools is a lot to put in front of a model at once. If your client supports tool filtering, narrow it to the groups you use.

What is covered

Every group in the contract: shows, seasons, episodes, movies, people, search, calendars, comments and reactions, lists and smart lists, notes, recommendations and social recommendations, scrobble, checkin, watchnow and JustWatch sources, certifications, countries, languages, genres, networks, and the whole sync and users surface: collection, history, watchlist, favorites, hidden items, ratings, playback progress and up next.

Setup

git clone https://github.com/rollecode/trakt-mcp.git
cd trakt-mcp
uv venv && uv pip install -e .

Create an application at trakt.tv/oauth/applications with the redirect URI urn:ietf:wg:oauth:2.0:oob, then:

export TRAKT_CLIENT_ID=...
export TRAKT_CLIENT_SECRET=...   # only needed for signing in

Claude Code

claude mcp add trakt -- /path/to/trakt-mcp/.venv/bin/trakt-mcp

Signing in

Public data needs only the client id. Anything under sync, users/me, checkin or scrobble needs an account:

  1. start_authentication returns a code and a URL

  2. Open the URL, enter the code

  3. finish_authentication with the same device code

The token lands in ~/.cache/trakt-mcp/token.json with mode 600 and is refreshed automatically shortly before it expires. clear_authentication revokes it.

Pagination

Trakt reports paging in headers rather than the body, so every result carries a pagination block alongside result when the endpoint is paged.

Hosting it

Running it over HTTP puts it in reach of Claude.ai as a custom connector, and of Claude Code on other machines. Three tiers, the same shape the other servers in this family use:

Tier

Port

What it does

trakt-mcp

8580

The server. No login of its own, never exposed

nginx

8581

Front door, behind a Cloudflare Tunnel

auth-server.js

8582

OAuth 2.1 sign-in, or a fixed bearer token

npm install
node set-password.js 'a password for the sign-in page'
printf 'TRAKT_CLIENT_ID=...\n' > ~/.config/trakt-mcp/env
chmod 600 ~/.config/trakt-mcp/env

Copy systemd/*.service into /etc/systemd/system/, replacing YOUR_USER and the ISSUER hostname, then:

sudo systemctl enable --now trakt-mcp trakt-mcp-auth

Point nginx/trakt-mcp.conf at your own hostname and send the tunnel at 127.0.0.1:8581.

Environment the server itself reads: TRAKT_CLIENT_ID, TRAKT_CLIENT_SECRET. The sign-in page carries the Trakt mark and accent colour, set through APP_NAME, APP_ACCENT and APP_BLURB in the auth unit.

Claude.ai

Settings, Connectors, Add custom connector, URL https://trakt-mcp.your-domain/mcp, client ID and secret blank. The sign-in page asks for the password set above. Connectors belong to the account, so adding it once covers mobile too.

Development

uv pip install -e . pytest ruff
.venv/bin/python -m pytest tests
.venv/bin/ruff check .

Available Tools

339 tools
clear_authenticationA
DestructiveIdempotent

Revoke the stored token and forget it.

Inputs: no named parameters. Returns: result

create_checkinA
Idempotent

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.

Inputs: body (required). Returns: result

create_commentsC
Idempotent

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.

Inputs: body (required). Returns: result

create_comments_by_id_likeB
Idempotent

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.

Inputs: id (required), body (required). Returns: result

create_comments_by_id_reactions_by_reaction_typeB
Idempotent

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.

Inputs: id (required), body (required), reaction_type (required). Returns: result

create_comments_by_id_repliesA
Idempotent

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.

Inputs: id (required), body (required). Returns: result

create_comments_by_id_reportB
Idempotent

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.

Inputs: id (required), body (required). Returns: result

create_episodes_by_id_reportC
Idempotent

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.

Inputs: id (required), body (required). Returns: result

create_lists_by_id_likeC
Idempotent

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.

Inputs: id (required), body (required). Returns: result

create_lists_by_id_reportC
Idempotent

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.

Inputs: id (required), body (required). Returns: result

create_movies_by_id_refreshA
Idempotent

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.

Inputs: id (required), body (required), images. Returns: result

create_movies_by_id_refresh_justwatchA
Idempotent

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.

Inputs: id (required), body (required). Returns: result

create_movies_by_id_reportB
Idempotent

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.

Inputs: id (required), body (required). Returns: result

create_notesB
Idempotent

Add notes.

POST /notes

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

Inputs: body (required). Returns: result

create_oauth_device_codeB
Idempotent

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.

Inputs: body (required). Returns: result

create_oauth_device_tokenC
Idempotent

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.

Inputs: body (required). Returns: result

create_oauth_revokeB
Idempotent

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.

Inputs: body (required). Returns: result

create_oauth_tokenC
Idempotent

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.

Inputs: body (required). Returns: result

create_people_by_id_refreshA
Idempotent

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.

Inputs: id (required), body (required), images. Returns: result

create_people_by_id_reportC
Idempotent

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.

Inputs: id (required), body (required). Returns: result

create_scrobble_pauseA
Idempotent

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.

Inputs: body (required). Returns: result

create_scrobble_startB
Idempotent

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.

Inputs: body (required). Returns: result

create_scrobble_stopB
Idempotent

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.

Inputs: body (required). Returns: result

create_search_recentB
Idempotent

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.

Inputs: body (required). Returns: result

create_search_recent_removeC
Idempotent

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.

Inputs: body (required). Returns: result

create_seasons_by_id_reportB
Idempotent

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.

Inputs: id (required), body (required). Returns: result

create_shows_by_id_progress_watched_resetB
Idempotent

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.

Inputs: id (required), body (required). Returns: result

create_shows_by_id_refreshA
Idempotent

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.

Inputs: id (required), body (required), images. Returns: result

create_shows_by_id_refresh_justwatchA
Idempotent

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.

Inputs: id (required), body (required). Returns: result

create_shows_by_id_reportB
Idempotent

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.

Inputs: id (required), body (required). Returns: result

create_shows_by_id_seasons_by_season_episodes_by_episode_reportB
Idempotent

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.

Inputs: id (required), body (required), season (required), episode (required). Returns: result

create_shows_by_id_seasons_by_season_reportB
Idempotent

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.

Inputs: id (required), body (required), season (required). Returns: result

create_sync_collectionB
Idempotent

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.

Inputs: body (required). Returns: result

create_sync_collection_removeB
Idempotent

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.

Inputs: body (required). Returns: result

create_sync_favoritesC
Idempotent

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.

Inputs: body (required). Returns: result

create_sync_favorites_removeB
Idempotent

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.

Inputs: body (required). Returns: result

create_sync_favorites_reorderC
Idempotent

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.

Inputs: body (required). Returns: result

create_sync_historyA
Idempotent

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.

Inputs: body (required). Returns: result

create_sync_history_removeB
Idempotent

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.

Inputs: body (required). Returns: result

create_sync_ratingsA
Idempotent

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.

Inputs: body (required). Returns: result

create_sync_ratings_removeC
Idempotent

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.

Inputs: body (required). Returns: result

create_sync_watchlistA
Idempotent

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.

Inputs: body (required). Returns: result

create_sync_watchlist_removeC
Idempotent

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.

Inputs: body (required). Returns: result

create_sync_watchlist_reorderB
Idempotent

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.

Inputs: body (required). Returns: result

create_users_by_id_blockC
Idempotent

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.

Inputs: id (required), body (required). Returns: result

create_users_by_id_followA
Idempotent

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.

Inputs: id (required), body (required). Returns: result

create_users_by_id_listsC
Idempotent

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.

Inputs: id (required), body (required). Returns: result

create_users_by_id_lists_by_list_id_itemsB
Idempotent

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.

Inputs: id (required), body (required), list_id (required). Returns: result

create_users_by_id_lists_by_list_id_items_removeB
Idempotent

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.

Inputs: id (required), body (required), list_id (required). Returns: result

create_users_by_id_lists_by_list_id_items_reorderB
Idempotent

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.

Inputs: id (required), body (required), list_id (required). Returns: result

create_users_by_id_lists_by_list_id_likeC
Idempotent

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.

Inputs: id (required), body (required), list_id (required). Returns: result

create_users_by_id_lists_by_list_id_reorderC
Idempotent

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.

Inputs: id (required), body (required), list_id (required). Returns: result

create_users_by_id_lists_by_list_id_reportC
Idempotent

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.

Inputs: id (required), body (required), list_id (required). Returns: result

create_users_by_id_lists_reorderB
Idempotent

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.

Inputs: id (required), body (required). Returns: result

create_users_by_id_reportC
Idempotent

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.

Inputs: id (required), body (required). Returns: result

create_users_by_id_smart_listsC
Idempotent

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.

Inputs: id (required), body (required). Returns: result

create_users_hidden_by_sectionB
Idempotent

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.

Inputs: body (required), section (required). Returns: result

create_users_hidden_by_section_removeB
Idempotent

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.

Inputs: body (required), section (required). Returns: result

create_users_hidden_calendar_removeA
Idempotent

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.

Inputs: body (required). Returns: result

create_users_hidden_progress_watched_removeC
Idempotent

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.

Inputs: body (required). Returns: result

create_users_requests_by_idA
Idempotent

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.

Inputs: id (required), body (required), extended. Returns: result

create_users_saved_filtersA
Idempotent

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.

Inputs: body (required). Returns: result

create_users_settings_plex_connectC
Idempotent

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.

Inputs: body (required). Returns: result

create_users_settings_plex_syncC
Idempotent

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.

Inputs: body (required). Returns: result

create_younify_connectB
Idempotent

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.

Inputs: body (required). Returns: result

create_younify_users_refresh_by_service_idB
Idempotent

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.

Inputs: body (required), service_id (required). Returns: result

create_younify_users_refresh_by_service_id_by_all_dataB
Idempotent

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.

Inputs: body (required), all_data (required), service_id (required). Returns: result

delete_checkinB
DestructiveIdempotent

Delete any active checkins.

DELETE /checkin

Inputs: no named parameters. Returns: result

delete_comments_by_idA
DestructiveIdempotent

Delete a comment or reply.

DELETE /comments/{id}/

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

Inputs: id (required). Returns: result

delete_comments_by_id_likeA
DestructiveIdempotent

Remove like on a comment.

DELETE /comments/{id}/like

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

Inputs: id (required). Returns: result

delete_comments_by_id_reactions_by_reaction_typeC
DestructiveIdempotent

Remove comment reaction.

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

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

Inputs: id (required), reaction_type (required). Returns: result

delete_lists_by_id_likeC
DestructiveIdempotent

Remove like on a list.

DELETE /lists/{id}/like

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

Inputs: id (required). Returns: result

delete_notes_by_idA
DestructiveIdempotent

Delete a note.

DELETE /notes/{id}

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

Inputs: id (required). Returns: result

delete_recommendations_movies_by_idA
DestructiveIdempotent

Hide a movie recommendation.

DELETE /recommendations/movies/{id}

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

Inputs: id (required). Returns: result

delete_recommendations_shows_by_idB
DestructiveIdempotent

Hide a show recommendation.

DELETE /recommendations/shows/{id}

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

Inputs: id (required). Returns: result

delete_shows_by_id_progress_watched_resetB
DestructiveIdempotent

Undo reset show progress.

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

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

Inputs: id (required). Returns: result

delete_sync_playback_by_idB
DestructiveIdempotent

Remove a playback item.

DELETE /sync/playback/{id}

Args: id: ID of the playback entry

Inputs: id (required). Returns: result

delete_users_by_id_blockA
DestructiveIdempotent

Unblock this user.

DELETE /users/{id}/block

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

Inputs: id (required). Returns: result

delete_users_by_id_followA
DestructiveIdempotent

Unfollow this user.

DELETE /users/{id}/follow

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

Inputs: id (required). Returns: result

delete_users_by_id_lists_by_list_idB
DestructiveIdempotent

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.

Inputs: id (required), list_id (required). Returns: result

delete_users_by_id_lists_by_list_id_likeC
DestructiveIdempotent

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.

Inputs: id (required), list_id (required). Returns: result

delete_users_by_id_smart_lists_by_list_idA
DestructiveIdempotent

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.

Inputs: id (required), list_id (required). Returns: result

delete_users_requests_by_idB
DestructiveIdempotent

Deny follow request.

DELETE /users/requests/{id}

Args: id: Path parameter.

Inputs: id (required). Returns: result

delete_users_saved_filters_by_idB
DestructiveIdempotent

Delete saved filter.

DELETE /users/saved_filters/{id}

Args: id: ID of the saved filter

Inputs: id (required). Returns: result

delete_users_settings_plex_connectA
DestructiveIdempotent

Disconnect Plex.

DELETE /users/settings/plex/connect

Inputs: no named parameters. Returns: result

delete_users_syncs_by_idB
DestructiveIdempotent

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.

Inputs: id (required). Returns: result

delete_younify_users_services_by_service_idB
DestructiveIdempotent

Unlink a streaming service.

DELETE /younify/users/services/{service_id}

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

Inputs: service_id (required). Returns: result

finish_authenticationA
Idempotent

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.

Inputs: device_code (required), wait_seconds. Returns: result

get_authentication_statusA
Read-onlyIdempotent

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

Inputs: no named parameters. Returns: result

get_calendars_by_target_dvd_by_start_date_by_daysA
Read-onlyIdempotent

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.

Inputs: days (required), target (required), start_date (required), years, +13 more. Returns: result

get_calendars_by_target_media_by_start_date_by_daysA
Read-onlyIdempotent

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.

Inputs: days (required), target (required), start_date (required), type, +12 more. Returns: result

get_calendars_by_target_movies_by_start_date_by_daysC
Read-onlyIdempotent

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.

Inputs: days (required), target (required), start_date (required), years, +13 more. Returns: result

get_calendars_by_target_shows_by_start_date_by_daysC
Read-onlyIdempotent

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.

Inputs: days (required), target (required), start_date (required), group, +14 more. Returns: result

get_calendars_by_target_shows_finales_by_start_date_by_daysC
Read-onlyIdempotent

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.

Inputs: days (required), target (required), start_date (required), years, +13 more. Returns: result

get_calendars_by_target_shows_new_by_start_date_by_daysB
Read-onlyIdempotent

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.

Inputs: days (required), target (required), start_date (required), years, +13 more. Returns: result

get_calendars_by_target_shows_premieres_by_start_date_by_daysB
Read-onlyIdempotent

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.

Inputs: days (required), target (required), start_date (required), years, +13 more. Returns: result

get_calendars_by_target_streaming_by_start_date_by_daysB
Read-onlyIdempotent

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.

Inputs: days (required), target (required), start_date (required), years, +13 more. Returns: result

get_calendars_releases_hot_by_start_date_by_daysB
Read-onlyIdempotent

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.

Inputs: days (required), start_date (required), type, group, +11 more. Returns: result

get_calendars_releases_hot_finales_by_start_date_by_daysC
Read-onlyIdempotent

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.

Inputs: days (required), start_date (required), years, genres, +9 more. Returns: result

get_calendars_releases_hot_new_by_start_date_by_daysC
Read-onlyIdempotent

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.

Inputs: days (required), start_date (required), years, genres, +9 more. Returns: result

get_calendars_releases_hot_premieres_by_start_date_by_daysC
Read-onlyIdempotent

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.

Inputs: days (required), start_date (required), years, genres, +9 more. Returns: result

get_certifications_by_typeC
Read-onlyIdempotent

Get certifications.

GET /certifications/{type}

Args: type: Certification media type.

Inputs: type (required). Returns: result

get_comments_by_idA
Read-onlyIdempotent

Get a comment or reply.

GET /comments/{id}

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

Inputs: id (required). Returns: result

get_comments_by_id_itemA
Read-onlyIdempotent

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.

Inputs: id (required), extended. Returns: result

get_comments_by_id_likesA
Read-onlyIdempotent

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.

Inputs: id (required), page, limit. Returns: result

get_comments_by_id_reactionsB
Read-onlyIdempotent

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

Inputs: id (required), page, limit, extended. Returns: result

get_comments_by_id_reactions_summaryC
Read-onlyIdempotent

Get reaction summary.

GET /comments/{id}/reactions/summary

Args: id: Path parameter.

Inputs: id (required). Returns: result

get_comments_by_id_repliesA
Read-onlyIdempotent

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.

Inputs: id (required), page, limit, extended. Returns: result

get_comments_recent_by_comment_type_by_typeB
Read-onlyIdempotent

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.

Inputs: type (required), comment_type (required), page, limit, +2 more. Returns: result

get_comments_updates_by_comment_type_by_typeC
Read-onlyIdempotent

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.

Inputs: type (required), comment_type (required), page, limit, +2 more. Returns: result

get_countries_by_typeA
Read-onlyIdempotent

Get countries.

GET /countries/{type}

Args: type: Media type to return countries for.

Inputs: type (required). Returns: result

get_episodes_by_id_watchnow_by_countryB
Read-onlyIdempotent

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.

Inputs: id (required), country (required), links, extended. Returns: result

get_genres_by_typeC
Read-onlyIdempotent

Get genres.

GET /genres/{type}

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

Inputs: type (required), extended. Returns: result

get_languages_by_typeB
Read-onlyIdempotent

Get languages.

GET /languages/{type}

Args: type: Media type to return languages for.

Inputs: type (required). Returns: result

get_lists_by_idC
Read-onlyIdempotent

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.

Inputs: id (required), years, genres, ratings, +11 more. Returns: result

get_lists_by_id_comments_by_sortB
Read-onlyIdempotent

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

Inputs: id (required), sort (required), page, limit, +1 more. Returns: result

get_lists_by_id_items_by_type_by_sort_by_by_sort_howC
Read-onlyIdempotent

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

Inputs: id (required), type (required), sort_by (required), sort_how (required), +16 more. Returns: result

get_lists_by_id_items_movieC
Read-onlyIdempotent

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

Inputs: id (required), page, limit, years, +15 more. Returns: result

get_lists_by_id_items_movie_showB
Read-onlyIdempotent

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

Inputs: id (required), page, limit, years, +15 more. Returns: result

get_lists_by_id_items_movie_show_episode_seasonC
Read-onlyIdempotent

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

Inputs: id (required), page, limit, years, +15 more. Returns: result

get_lists_by_id_items_showC
Read-onlyIdempotent

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

Inputs: id (required), page, limit, years, +15 more. Returns: result

get_lists_by_id_likesA
Read-onlyIdempotent

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.

Inputs: id (required), page, limit, extended. Returns: result

get_movies_by_idA
Read-onlyIdempotent

Get a movie.

GET /movies/{id}

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

Inputs: id (required), extended. Returns: result

get_movies_by_id_aliasesB
Read-onlyIdempotent

Get all movie aliases.

GET /movies/{id}/aliases

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

Inputs: id (required). Returns: result

get_movies_by_id_comments_by_sortB
Read-onlyIdempotent

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

Inputs: id (required), sort (required), page, limit, +2 more. Returns: result

get_movies_by_id_lists_by_type_by_sortB
Read-onlyIdempotent

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.

Inputs: id (required), sort (required), type (required), page, +2 more. Returns: result

get_movies_by_id_peopleA
Read-onlyIdempotent

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.

Inputs: id (required), extended. Returns: result

get_movies_by_id_ratingsA
Read-onlyIdempotent

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.

Inputs: id (required), extended. Returns: result

get_movies_by_id_releases_by_countryA
Read-onlyIdempotent

Get all movie releases.

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

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

Inputs: id (required), country (required). Returns: result

get_movies_by_id_sentimentsC
Read-onlyIdempotent

Get movie sentiments.

GET /movies/{id}/sentiments

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

Inputs: id (required). Returns: result

get_movies_by_id_statsB
Read-onlyIdempotent

Get movie stats.

GET /movies/{id}/stats

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

Inputs: id (required). Returns: result

get_movies_by_id_studiosA
Read-onlyIdempotent

Get movie studios.

GET /movies/{id}/studios

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

Inputs: id (required). Returns: result

get_movies_by_id_translationsA
Read-onlyIdempotent

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

Inputs: id (required), language. Returns: result

get_movies_by_id_videosB
Read-onlyIdempotent

Get all videos.

GET /movies/{id}/videos

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

Inputs: id (required). Returns: result

get_movies_by_id_watchingB
Read-onlyIdempotent

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.

Inputs: id (required), extended. Returns: result

get_movies_by_id_watchnow_by_countryC
Read-onlyIdempotent

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.

Inputs: id (required), country (required), links, extended. Returns: result

get_movies_collected_by_periodA
Read-onlyIdempotent

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.

Inputs: period (required), page, limit, extended, +3 more. Returns: result

get_movies_favorited_by_periodA
Read-onlyIdempotent

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.

Inputs: period (required), page, limit, extended, +3 more. Returns: result

get_movies_played_by_periodB
Read-onlyIdempotent

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.

Inputs: period (required), page, limit, extended, +3 more. Returns: result

get_movies_streaming_by_periodC
Read-onlyIdempotent

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.

Inputs: period (required), page, limit, years, +13 more. Returns: result

get_movies_updates_by_start_dateA
Read-onlyIdempotent

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.

Inputs: start_date (required), page, limit, extended. Returns: result

get_movies_updates_id_by_start_dateB
Read-onlyIdempotent

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.

Inputs: start_date (required), page, limit. Returns: result

get_movies_watched_by_periodA
Read-onlyIdempotent

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.

Inputs: period (required), page, limit, extended, +3 more. Returns: result

get_notes_by_idC
Read-onlyIdempotent

Get a note.

GET /notes/{id}

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

Inputs: id (required). Returns: result

get_notes_by_id_itemB
Read-onlyIdempotent

Get the attached item.

GET /notes/{id}/item

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

Inputs: id (required). Returns: result

get_people_by_idA
Read-onlyIdempotent

Get a single person.

GET /people/{id}/

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

Inputs: id (required), extended. Returns: result

get_people_by_id_lists_by_type_by_sortB
Read-onlyIdempotent

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.

Inputs: id (required), sort (required), type (required), page, +2 more. Returns: result

get_people_by_id_moviesC
Read-onlyIdempotent

Get movie credits.

GET /people/{id}/movies

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

Inputs: id (required), extended. Returns: result

get_people_by_id_showsB
Read-onlyIdempotent

Get show credits.

GET /people/{id}/shows

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

Inputs: id (required), extended. Returns: result

get_people_updates_by_start_dateB
Read-onlyIdempotent

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.

Inputs: start_date (required), page, limit, extended. Returns: result

get_people_updates_id_by_start_dateA
Read-onlyIdempotent

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.

Inputs: start_date (required), page, limit. Returns: result

get_result_pageA
Read-onlyIdempotent

Read more of a result that was too large to return in one piece.

Any tool whose answer is too large returns its first page with a paging block. Pass that block's result_id here. Nothing is fetched again: the stored result is paged, filtered and narrowed.

Args: result_id: From the paging block of the earlier answer. offset: First item to return, usually the previous next_offset. limit: At most this many items. Fewer come back if they would not fit. fields: Only these keys of each item. Dots reach nested keys, such as "statistics.sizeOnDisk". The paging.fields list shows what exists. match: Keep only items whose field contains this text, ignoring case, for example {"title": "alien", "year": "1979"}. path: Which list to page when the result holds several, as named in paging.lists. Defaults to the largest.

Inputs: result_id (required), path, limit, match, +2 more. Returns: result

get_search_by_id_type_by_idA
Read-onlyIdempotent

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.

Inputs: id (required), id_type (required), page, type, +2 more. Returns: result

get_search_by_typeA
Read-onlyIdempotent

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.

Inputs: type (required), page, limit, query, +1 more. Returns: result

get_search_by_type_exactB
Read-onlyIdempotent

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.

Inputs: type (required), page, limit, query, +1 more. Returns: result

get_search_recent_by_id_global_by_typeA
Read-onlyIdempotent

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.

Inputs: type (required), page, limit, query, +1 more. Returns: result

get_shows_by_idA
Read-onlyIdempotent

Get a single show.

GET /shows/{id}

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

Inputs: id (required), extended. Returns: result

get_shows_by_id_aliasesB
Read-onlyIdempotent

Get all show aliases.

GET /shows/{id}/aliases

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

Inputs: id (required). Returns: result

get_shows_by_id_certificationsA
Read-onlyIdempotent

Get all show certifications.

GET /shows/{id}/certifications

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

Inputs: id (required). Returns: result

get_shows_by_id_comments_by_sortB
Read-onlyIdempotent

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

Inputs: id (required), sort (required), page, limit, +2 more. Returns: result

get_shows_by_id_last_episodeA
Read-onlyIdempotent

Get last episode.

GET /shows/{id}/last_episode

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

Inputs: id (required), extended. Returns: result

get_shows_by_id_lists_by_type_by_sortA
Read-onlyIdempotent

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.

Inputs: id (required), sort (required), type (required), page, +2 more. Returns: result

get_shows_by_id_next_episodeB
Read-onlyIdempotent

Get next episode.

GET /shows/{id}/next_episode

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

Inputs: id (required), extended. Returns: result

get_shows_by_id_peopleB
Read-onlyIdempotent

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.

Inputs: id (required), extended. Returns: result

get_shows_by_id_progress_collectionA
Read-onlyIdempotent

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

Inputs: id (required), hidden, extended, specials, +2 more. Returns: result

get_shows_by_id_progress_watchedA
Read-onlyIdempotent

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

Inputs: id (required), hidden, extended, specials, +2 more. Returns: result

get_shows_by_id_ratingsB
Read-onlyIdempotent

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.

Inputs: id (required), extended. Returns: result

get_shows_by_id_seasonsC
Read-onlyIdempotent

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.

Inputs: id (required), extended. Returns: result

get_shows_by_id_seasons_by_seasonA
Read-onlyIdempotent

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.

Inputs: id (required), season (required), extended. Returns: result

get_shows_by_id_seasons_by_season_comments_by_sortB
Read-onlyIdempotent

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

Inputs: id (required), sort (required), season (required), page, +3 more. Returns: result

get_shows_by_id_seasons_by_season_episodes_by_episodeB
Read-onlyIdempotent

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.

Inputs: id (required), season (required), episode (required), extended. Returns: result

get_shows_by_id_seasons_by_season_episodes_by_episode_comments_by_sortB
Read-onlyIdempotent

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

Inputs: id (required), sort (required), season (required), episode (required), +4 more. Returns: result

get_shows_by_id_seasons_by_season_episodes_by_episode_lists_by_type_by_sortA
Read-onlyIdempotent

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.

Inputs: id (required), sort (required), type (required), season (required), +4 more. Returns: result

get_shows_by_id_seasons_by_season_episodes_by_episode_peopleA
Read-onlyIdempotent

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.

Inputs: id (required), season (required), episode (required), extended. Returns: result

get_shows_by_id_seasons_by_season_episodes_by_episode_ratingsA
Read-onlyIdempotent

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.

Inputs: id (required), season (required), episode (required), extended. Returns: result

get_shows_by_id_seasons_by_season_episodes_by_episode_statsB
Read-onlyIdempotent

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

Inputs: id (required), season (required), episode (required). Returns: result

get_shows_by_id_seasons_by_season_episodes_by_episode_translationsA
Read-onlyIdempotent

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

Inputs: id (required), season (required), episode (required), language. Returns: result

get_shows_by_id_seasons_by_season_episodes_by_episode_videosB
Read-onlyIdempotent

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

Inputs: id (required), season (required), episode (required). Returns: result

get_shows_by_id_seasons_by_season_episodes_by_episode_watchingB
Read-onlyIdempotent

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.

Inputs: id (required), season (required), episode (required), extended. Returns: result

get_shows_by_id_seasons_by_season_episodes_by_episode_watchnow_by_countryC
Read-onlyIdempotent

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.

Inputs: id (required), season (required), country (required), episode (required), +2 more. Returns: result

get_shows_by_id_seasons_by_season_infoB
Read-onlyIdempotent

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.

Inputs: id (required), season (required), extended. Returns: result

get_shows_by_id_seasons_by_season_lists_by_type_by_sortB
Read-onlyIdempotent

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.

Inputs: id (required), sort (required), type (required), season (required), +3 more. Returns: result

get_shows_by_id_seasons_by_season_peopleB
Read-onlyIdempotent

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.

Inputs: id (required), season (required), extended. Returns: result

get_shows_by_id_seasons_by_season_ratingsA
Read-onlyIdempotent

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.

Inputs: id (required), season (required), extended. Returns: result

get_shows_by_id_seasons_by_season_statsC
Read-onlyIdempotent

Get season stats.

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

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

Inputs: id (required), season (required). Returns: result

get_shows_by_id_seasons_by_season_translationsA
Read-onlyIdempotent

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

Inputs: id (required), season (required), language. Returns: result

get_shows_by_id_seasons_by_season_videosB
Read-onlyIdempotent

Get all videos.

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

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

Inputs: id (required), season (required). Returns: result

get_shows_by_id_seasons_by_season_watchingC
Read-onlyIdempotent

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.

Inputs: id (required), season (required), extended. Returns: result

get_shows_by_id_sentimentsA
Read-onlyIdempotent

Get show sentiments.

GET /shows/{id}/sentiments

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

Inputs: id (required). Returns: result

get_shows_by_id_statsC
Read-onlyIdempotent

Get show stats.

GET /shows/{id}/stats

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

Inputs: id (required). Returns: result

get_shows_by_id_studiosC
Read-onlyIdempotent

Get show studios.

GET /shows/{id}/studios

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

Inputs: id (required). Returns: result

get_shows_by_id_translationsA
Read-onlyIdempotent

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

Inputs: id (required), language. Returns: result

get_shows_by_id_videosC
Read-onlyIdempotent

Get all videos.

GET /shows/{id}/videos

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

Inputs: id (required). Returns: result

get_shows_by_id_watchingC
Read-onlyIdempotent

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.

Inputs: id (required), extended. Returns: result

get_shows_by_id_watchnow_by_countryB
Read-onlyIdempotent

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.

Inputs: id (required), country (required), links, extended. Returns: result

get_shows_collected_by_periodA
Read-onlyIdempotent

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.

Inputs: period (required), page, limit, years, +13 more. Returns: result

get_shows_favorited_by_periodB
Read-onlyIdempotent

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.

Inputs: period (required), page, limit, years, +13 more. Returns: result

get_shows_played_by_periodC
Read-onlyIdempotent

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.

Inputs: period (required), page, limit, years, +13 more. Returns: result

get_shows_streaming_by_periodB
Read-onlyIdempotent

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.

Inputs: period (required), page, limit, years, +13 more. Returns: result

get_shows_updates_by_start_dateA
Read-onlyIdempotent

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.

Inputs: start_date (required), page, limit, extended. Returns: result

get_shows_updates_id_by_start_dateA
Read-onlyIdempotent

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.

Inputs: start_date (required), page, limit. Returns: result

get_shows_watched_by_periodC
Read-onlyIdempotent

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.

Inputs: period (required), page, limit, years, +13 more. Returns: result

get_smart_lists_by_list_idC
Read-onlyIdempotent

Get smart list.

GET /smart-lists/{list_id}

Args: list_id: Path parameter.

Inputs: list_id (required). Returns: result

get_smart_lists_by_list_id_itemsC
Read-onlyIdempotent

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

Inputs: list_id (required), page, limit, years, +10 more. Returns: result

get_sync_collection_by_typeD
Read-onlyIdempotent

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.

Inputs: type (required), page, limit, extended, +1 more. Returns: result

get_sync_favorites_by_type_by_sort_by_by_sort_howB
Read-onlyIdempotent

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.

Inputs: type (required), sort_by (required), sort_how (required), page, +2 more. Returns: result

get_sync_history_by_type_by_idB
Read-onlyIdempotent

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".

Inputs: id (required), type (required), page, limit, +3 more. Returns: result

get_sync_playback_by_typeB
Read-onlyIdempotent

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".

Inputs: type (required), page, limit, years, +12 more. Returns: result

get_sync_ratings_by_type_by_ratingC
Read-onlyIdempotent

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.

Inputs: type (required), rating (required), page, limit, +1 more. Returns: result

get_sync_watched_by_typeC
Read-onlyIdempotent

Get watched.

GET /sync/watched/{type}

Args: type: Sync 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.

Inputs: type (required), page, limit, extended. Returns: result

get_sync_watchlist_by_type_by_sort_by_by_sort_howC
Read-onlyIdempotent

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.

Inputs: type (required), sort_by (required), sort_how (required), page, +2 more. Returns: result

get_users_by_idA
Read-onlyIdempotent

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.

Inputs: id (required), extended. Returns: result

get_users_by_id_by_type_activitiesC
Read-onlyIdempotent

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.

Inputs: id (required), type (required), page, limit, +14 more. Returns: result

get_users_by_id_collection_by_typeA
Read-onlyIdempotent

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.

Inputs: id (required), type (required), page, limit, +11 more. Returns: result

get_users_by_id_comments_by_comment_type_by_typeB
Read-onlyIdempotent

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.

Inputs: id (required), type (required), comment_type (required), page, +3 more. Returns: result

get_users_by_id_favorites_by_type_by_sort_by_by_sort_howA
Read-onlyIdempotent

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.

Inputs: id (required), type (required), sort_by (required), sort_how (required), +5 more. Returns: result

get_users_by_id_favorites_comments_by_sortB
Read-onlyIdempotent

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.

Inputs: id (required), sort (required), page, limit. Returns: result

get_users_by_id_favorites_media_by_sortC
Read-onlyIdempotent

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.

Inputs: id (required), sort (required), page, limit, +3 more. Returns: result

get_users_by_id_favorites_movies_by_sortC
Read-onlyIdempotent

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.

Inputs: id (required), sort (required), page, limit, +3 more. Returns: result

get_users_by_id_favorites_shows_by_sortB
Read-onlyIdempotent

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.

Inputs: id (required), sort (required), page, limit, +3 more. Returns: result

get_users_by_id_followersA
Read-onlyIdempotent

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.

Inputs: id (required), extended. Returns: result

get_users_by_id_followingB
Read-onlyIdempotent

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.

Inputs: id (required), extended. Returns: result

get_users_by_id_friendsB
Read-onlyIdempotent

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.

Inputs: id (required), extended. Returns: result

get_users_by_id_historyB
Read-onlyIdempotent

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.

Inputs: id (required), page, limit, years, +12 more. Returns: result

get_users_by_id_history_by_type_by_item_idA
Read-onlyIdempotent

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.

Inputs: id (required), type (required), item_id (required), page, +4 more. Returns: result

get_users_by_id_history_episodesC
Read-onlyIdempotent

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.

Inputs: id (required), page, limit, years, +12 more. Returns: result

get_users_by_id_history_episodes_by_item_idB
Read-onlyIdempotent

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.

Inputs: id (required), item_id (required), page, limit, +3 more. Returns: result

get_users_by_id_history_moviesA
Read-onlyIdempotent

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.

Inputs: id (required), page, limit, years, +12 more. Returns: result

get_users_by_id_history_movies_by_item_idA
Read-onlyIdempotent

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.

Inputs: id (required), item_id (required), page, limit, +3 more. Returns: result

get_users_by_id_history_showsB
Read-onlyIdempotent

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.

Inputs: id (required), page, limit, years, +12 more. Returns: result

get_users_by_id_history_shows_by_item_idB
Read-onlyIdempotent

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.

Inputs: id (required), item_id (required), page, limit, +3 more. Returns: result

get_users_by_id_likes_by_typeB
Read-onlyIdempotent

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

Inputs: id (required), type (required), page, limit, +1 more. Returns: result

get_users_by_id_listsA
Read-onlyIdempotent

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.

Inputs: id (required), page, limit, extended. Returns: result

get_users_by_id_lists_by_list_idA
Read-onlyIdempotent

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.

Inputs: id (required), list_id (required), extended. Returns: result

get_users_by_id_lists_by_list_id_comments_by_sortC
Read-onlyIdempotent

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.

Inputs: id (required), sort (required), list_id (required), page, +1 more. Returns: result

get_users_by_id_lists_by_list_id_items_by_type_by_sort_by_by_sort_howB
Read-onlyIdempotent

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

Inputs: id (required), type (required), list_id (required), sort_by (required), +17 more. Returns: result

get_users_by_id_lists_by_list_id_items_movieC
Read-onlyIdempotent

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

Inputs: id (required), list_id (required), page, limit, +16 more. Returns: result

get_users_by_id_lists_by_list_id_items_movie_showC
Read-onlyIdempotent

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

Inputs: id (required), list_id (required), page, limit, +16 more. Returns: result

get_users_by_id_lists_by_list_id_items_movie_show_season_episodeA
Read-onlyIdempotent

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

Inputs: id (required), list_id (required), page, limit, +16 more. Returns: result

get_users_by_id_lists_by_list_id_items_showC
Read-onlyIdempotent

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

Inputs: id (required), list_id (required), page, limit, +16 more. Returns: result

get_users_by_id_lists_by_list_id_likesA
Read-onlyIdempotent

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.

Inputs: id (required), list_id (required), page, limit. Returns: result

get_users_by_id_lists_collaborationsA
Read-onlyIdempotent

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.

Inputs: id (required), extended. Returns: result

get_users_by_id_mir_by_year_by_monthC
Read-onlyIdempotent

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.

Inputs: id (required), year (required), month (required), extended. Returns: result

get_users_by_id_notes_by_typeB
Read-onlyIdempotent

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.

Inputs: id (required), type (required), page, limit, +1 more. Returns: result

get_users_by_id_ratingsB
Read-onlyIdempotent

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.

Inputs: id (required), page, limit, extended. Returns: result

get_users_by_id_ratings_by_type_by_ratingA
Read-onlyIdempotent

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.

Inputs: id (required), type (required), rating (required), page, +2 more. Returns: result

get_users_by_id_ratings_episodesA
Read-onlyIdempotent

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.

Inputs: id (required), page, limit, extended. Returns: result

get_users_by_id_ratings_moviesA
Read-onlyIdempotent

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.

Inputs: id (required), page, limit, extended. Returns: result

get_users_by_id_ratings_showsA
Read-onlyIdempotent

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.

Inputs: id (required), page, limit, extended. Returns: result

get_users_by_id_smart_listsB
Read-onlyIdempotent

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.

Inputs: id (required). Returns: result

get_users_by_id_smart_lists_by_list_idC
Read-onlyIdempotent

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.

Inputs: id (required), list_id (required). Returns: result

get_users_by_id_statsC
Read-onlyIdempotent

Get stats.

GET /users/{id}/stats

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

Inputs: id (required). Returns: result

get_users_by_id_watched_by_typeB
Read-onlyIdempotent

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).

Inputs: id (required), type (required), hidden, extended, +2 more. Returns: result

get_users_by_id_watched_moviesB
Read-onlyIdempotent

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.

Inputs: id (required), page, limit, extended. Returns: result

get_users_by_id_watched_showsB
Read-onlyIdempotent

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.

Inputs: id (required), page, limit, extended, +2 more. Returns: result

get_users_by_id_watchingC
Read-onlyIdempotent

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.

Inputs: id (required), extended. Returns: result

get_users_by_id_watchlist_by_type_by_sort_by_by_sort_howB
Read-onlyIdempotent

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.

Inputs: id (required), type (required), sort_by (required), sort_how (required), +16 more. Returns: result

get_users_by_id_watchlist_comments_by_sortA
Read-onlyIdempotent

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.

Inputs: id (required), sort (required), page, limit. Returns: result

get_users_by_id_watchlist_movies_by_sortB
Read-onlyIdempotent

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.

Inputs: id (required), sort (required), hide, page, +14 more. Returns: result

get_users_by_id_watchlist_movie_show_by_sortC
Read-onlyIdempotent

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.

Inputs: id (required), sort (required), hide, page, +14 more. Returns: result

get_users_by_id_watchlist_shows_by_sortB
Read-onlyIdempotent

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.

Inputs: id (required), sort (required), hide, page, +14 more. Returns: result

get_users_by_id_yir_by_yearC
Read-onlyIdempotent

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.

Inputs: id (required), year (required), extended. Returns: result

get_users_hidden_by_sectionB
Read-onlyIdempotent

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.

Inputs: section (required), page, type, limit, +1 more. Returns: result

get_users_saved_filters_by_sectionB
Read-onlyIdempotent

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.

Inputs: section (required), page, limit. Returns: result

get_users_settings_plex_servers_by_server_idB
Read-onlyIdempotent

Get Plex server accounts and libraries.

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

Args: server_id: The Plex server machine identifier.

Inputs: server_id (required). Returns: result

get_users_syncs_by_idB
Read-onlyIdempotent

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.

Inputs: id (required). Returns: result

get_users_syncs_by_id_pausedA
Read-onlyIdempotent

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.

Inputs: id (required), page, limit. Returns: result

get_users_syncs_by_id_skippedA
Read-onlyIdempotent

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.

Inputs: id (required), page, limit. Returns: result

get_users_syncs_by_typeA
Read-onlyIdempotent

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.

Inputs: type (required), page, limit. Returns: result

get_watchnow_sources_by_country_codeC
Read-onlyIdempotent

Get watch now sources by country.

GET /watchnow/sources/{countryCode}

Args: country_code: Path parameter.

Inputs: country_code (required). Returns: result

list_certifications_moviesB
Read-onlyIdempotent

Get movie certifications.

GET /certifications/movies

Inputs: no named parameters. Returns: result

list_certifications_showsA
Read-onlyIdempotent

Get show certifications.

GET /certifications/shows

Inputs: no named parameters. Returns: result

list_media_anticipatedB
Read-onlyIdempotent

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.

Inputs: page, limit, years, genres, +12 more. Returns: result

list_movies_anticipatedB
Read-onlyIdempotent

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.

Inputs: page, limit, years, genres, +12 more. Returns: result

list_movies_boxofficeA
Read-onlyIdempotent

Get the weekend box office.

GET /movies/boxoffice

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

Inputs: extended. Returns: result

list_movies_hotC
Read-onlyIdempotent

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.

Inputs: page, limit, years, genres, +12 more. Returns: result

list_networksB
Read-onlyIdempotent

Get networks.

GET /networks

Inputs: no named parameters. Returns: result

list_oauth_authorizeC
Read-onlyIdempotent

Authorize Application.

GET /oauth/authorize

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

Inputs: state, client_id, redirect_uri, response_type. Returns: result

list_recommendations_moviesB
Read-onlyIdempotent

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.

Inputs: limit, years, genres, ratings, +12 more. Returns: result

list_recommendations_showsB
Read-onlyIdempotent

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.

Inputs: limit, years, genres, ratings, +12 more. Returns: result

list_shows_anticipatedB
Read-onlyIdempotent

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.

Inputs: page, limit, years, genres, +12 more. Returns: result

list_shows_hotB
Read-onlyIdempotent

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.

Inputs: page, limit, years, genres, +12 more. Returns: result

list_social_recommendations_moviesB
Read-onlyIdempotent

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.

Inputs: limit, extended, watch_window, ignore_watched, +2 more. Returns: result

list_social_recommendations_showsB
Read-onlyIdempotent

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.

Inputs: limit, extended, watch_window, ignore_watched, +2 more. Returns: result

list_sync_collection_episodesC
Read-onlyIdempotent

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.

Inputs: page, limit, extended, available_on. Returns: result

list_sync_collection_mediaB
Read-onlyIdempotent

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.

Inputs: page, limit, extended, available_on. Returns: result

list_sync_collection_minimal_episodesC
Read-onlyIdempotent

Get minimal episode collection.

GET /sync/collection/minimal/episodes

Args: available_on: Query parameter.

Inputs: available_on. Returns: result

list_sync_collection_minimal_moviesC
Read-onlyIdempotent

Get minimal movie collection.

GET /sync/collection/minimal/movies

Args: available_on: Query parameter.

Inputs: available_on. Returns: result

list_sync_collection_minimal_showsC
Read-onlyIdempotent

Get minimal show collection.

GET /sync/collection/minimal/shows

Args: available_on: Query parameter.

Inputs: available_on. Returns: result

list_sync_collection_moviesB
Read-onlyIdempotent

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.

Inputs: page, limit, extended, available_on. Returns: result

list_sync_collection_showsC
Read-onlyIdempotent

Get show collection.

GET /sync/collection/shows

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.

Inputs: page, limit, extended, available_on. Returns: result

list_sync_last_activitiesC
Read-onlyIdempotent

Get last activity.

GET /sync/last_activities

Inputs: no named parameters. Returns: result

list_sync_playback_moviesB
Read-onlyIdempotent

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".

Inputs: page, limit, years, end_at, +11 more. Returns: result

list_sync_progress_up_nextB
Read-onlyIdempotent

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.

Inputs: page, limit, sort_by, extended, +3 more. Returns: result

list_sync_progress_up_next_nitroB
Read-onlyIdempotent

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.

Inputs: page, limit, years, genres, +11 more. Returns: result

list_sync_progress_watchedB
Read-onlyIdempotent

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).

Inputs: page, limit, sort_by, extended, +5 more. Returns: result

list_teamB
Read-onlyIdempotent

Get team members.

GET /team/

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

Inputs: extended. Returns: result

list_users_blockedB
Read-onlyIdempotent

Get blocked users.

GET /users/blocked

Inputs: no named parameters. Returns: result

list_users_hidden_droppedB
Read-onlyIdempotent

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.

Inputs: page, limit, extended. Returns: result

list_users_hidden_progress_watchedB
Read-onlyIdempotent

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.

Inputs: page, type, limit, extended. Returns: result

list_users_reactions_commentsC
Read-onlyIdempotent

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

Inputs: page, limit, extended. Returns: result

list_users_requestsC
Read-onlyIdempotent

Get follow requests.

GET /users/requests/

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

Inputs: extended. Returns: result

list_users_requests_followingC
Read-onlyIdempotent

Get pending following requests.

GET /users/requests/following

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

Inputs: extended. Returns: result

list_users_settingsC
Read-onlyIdempotent

Retrieve settings.

GET /users/settings

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

Inputs: extended. Returns: result

list_users_settings_plexB
Read-onlyIdempotent

Get Plex settings.

GET /users/settings/plex/

Inputs: no named parameters. Returns: result

list_users_settings_plex_serversA
Read-onlyIdempotent

Get Plex servers.

GET /users/settings/plex/servers

Inputs: no named parameters. Returns: result

list_users_syncsB
Read-onlyIdempotent

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.

Inputs: page, limit. Returns: result

list_watchnow_sourcesB
Read-onlyIdempotent

Get watch now sources.

GET /watchnow/sources

Inputs: no named parameters. Returns: result

list_younify_connectionsB
Read-onlyIdempotent

Get streaming connections.

GET /younify/connections

Inputs: no named parameters. Returns: result

start_authenticationA
Idempotent

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.

Inputs: no named parameters. Returns: result

update_comments_by_idA
Idempotent

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.

Inputs: id (required), body (required). Returns: result

update_notes_by_idA
Idempotent

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.

Inputs: id (required), body (required). Returns: result

update_sync_favoritesB
Idempotent

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.

Inputs: body (required). Returns: result

update_sync_favorites_by_list_item_idB
Idempotent

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.

Inputs: body (required), list_item_id (required). Returns: result

update_sync_watchlistC
Idempotent

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.

Inputs: body (required). Returns: result

update_sync_watchlist_by_list_item_idC
Idempotent

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.

Inputs: body (required), list_item_id (required). Returns: result

update_users_avatarA
Idempotent

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.

Inputs: body (required). Returns: result

update_users_by_id_lists_by_list_idB
Idempotent

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.

Inputs: id (required), body (required), list_id (required). Returns: result

update_users_by_id_lists_by_list_id_items_by_list_item_idA
Idempotent

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.

Inputs: id (required), body (required), list_id (required), list_item_id (required). Returns: result

update_users_by_id_smart_lists_by_list_idB
Idempotent

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.

Inputs: id (required), body (required), list_id (required). Returns: result

update_users_set_coverB
Idempotent

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.

Inputs: body (required). Returns: result

update_users_settingsB
Idempotent

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.

Inputs: body (required). Returns: result

update_users_settings_plexB
Idempotent

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.

Inputs: body (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.7/5.0

    Scored across 339 tools

    Disambiguation2/5

    The surface contains many near-duplicate read endpoints that differ only by path parameterization: get_users_by_id_ratings vs get_users_by_id_ratings_by_type_by_rating vs get_users_by_id_ratings_movies/shows/episodes, list_lists_popular vs get_lists_popular_by_type, get_sync_watchlist_by_type_by_sort_by_by_sort_how vs get_users_by_id_watchlist_movies_by_sort vs get_users_by_id_watchlist_by_type_by_sort_by_by_sort_how, and get_shows_by_id_seasons_by_season vs get_shows_by_id_seasons_by_season_info. Each maps to a distinct API endpoint, but an agent has to parse deep path-shaped names to tell them apart, which invites misselection.

    Naming Consistency3/5

    Most tools follow a mechanical verb_path pattern (get_movies_by_id_watchnow_by_country), which is at least predictable, but several reads use bare list_ names (list_team, list_networks, list_watchnow_sources, list_users_blocked, list_users_settings) while equivalent reads elsewhere use get_*_by_*. A handful of hand-written tools (start_authentication, finish_authentication, get_result_page) use a totally different, more human convention, so conventions are mixed.

    Tool Count1/5

    339 tools is an extreme over-expansion for a media-tracking domain; the vast majority are one-to-one wrappers of REST paths with heavy parameterized duplication. This far exceeds what an agent can navigate reliably and guarantees tool-selection noise.

    Completeness5/5

    Coverage mirrors the full Trakt API: auth, movies/shows/seasons/episodes/people, calendars, search, lists, comments, notes, sync (collection, history, ratings, watchlist, favorites, playback), recommendations, social, Plex and streaming connections. CRUD is present for user data, lists, comments, and notes, with no obvious dead ends.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      B
      maintenance
      Enables full control of Sonarr from Claude.ai and Claude Code by exposing all 234 v3 API operations as tools for managing media libraries.
      235
      23 npm
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Enables running Plex from Claude.ai and Claude Code by exposing all 405 operations as tools, covering both your media server and plex.tv cloud services with automatic routing to the appropriate host.
      28
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables Claude to read Simkl watch history, log watched items, manage library status, and search titles.
      14
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Connects a personal Trakt account to Claude or Codex so users can get personalized movie and TV recommendations, review watched history and play counts, and search for titles by natural language. Access is read-only and never modifies Trakt history or ratings.
      117 npm
      GPL 3.0