Trakt MCP server
Provides tools for interacting with the Trakt API, covering a wide range of features such as shows, movies, seasons, episodes, people, comments, lists, calendars, scrobbling, check-ins, and user sync data like history, watchlist, ratings, and favorites.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Trakt MCP server What movies are trending on Trakt right now?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Trakt MCP server
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.
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 |
| 79 | 24 % |
| 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.pyThis 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 |
| Read a collection |
|
| Read one record |
|
| POST |
|
| PUT |
|
| DELETE |
|
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 inClaude Code
claude mcp add trakt -- /path/to/trakt-mcp/.venv/bin/trakt-mcpSigning in
Public data needs only the client id. Anything under sync, users/me, checkin or scrobble needs an account:
start_authenticationreturns a code and a URLOpen the URL, enter the code
finish_authenticationwith 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 |
| 8580 | The server. No login of its own, never exposed |
nginx | 8581 | Front door, behind a Cloudflare Tunnel |
| 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/envCopy systemd/*.service into /etc/systemd/system/, replacing YOUR_USER and the ISSUER hostname, then:
sudo systemctl enable --now trakt-mcp trakt-mcp-authPoint 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 toolsclear_authenticationADestructiveIdempotent
Revoke the stored token and forget it.
Inputs: no named parameters. Returns: result
create_checkinAIdempotent
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_commentsCIdempotent
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_likeBIdempotent
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_typeBIdempotent
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_repliesAIdempotent
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_reportBIdempotent
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_reportCIdempotent
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_likeCIdempotent
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_reportCIdempotent
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_refreshAIdempotent
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_justwatchAIdempotent
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_reportBIdempotent
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_notesBIdempotent
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_codeBIdempotent
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_tokenCIdempotent
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_revokeBIdempotent
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_tokenCIdempotent
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_refreshAIdempotent
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_reportCIdempotent
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_pauseAIdempotent
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_startBIdempotent
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_stopBIdempotent
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_recentBIdempotent
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_removeCIdempotent
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_reportBIdempotent
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_resetBIdempotent
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_refreshAIdempotent
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_justwatchAIdempotent
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_reportBIdempotent
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_reportBIdempotent
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_reportBIdempotent
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_collectionBIdempotent
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_removeBIdempotent
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_favoritesCIdempotent
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_removeBIdempotent
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_reorderCIdempotent
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_historyAIdempotent
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_removeBIdempotent
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_ratingsAIdempotent
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_removeCIdempotent
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_watchlistAIdempotent
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_removeCIdempotent
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_reorderBIdempotent
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_blockCIdempotent
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_followAIdempotent
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_listsCIdempotent
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_itemsBIdempotent
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_removeBIdempotent
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_reorderBIdempotent
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_likeCIdempotent
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_reorderCIdempotent
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_reportCIdempotent
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_reorderBIdempotent
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_reportCIdempotent
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_listsCIdempotent
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_requests_by_idAIdempotent
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_filtersAIdempotent
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_connectCIdempotent
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_syncCIdempotent
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_connectBIdempotent
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_idBIdempotent
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_dataBIdempotent
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_checkinBDestructiveIdempotent
Delete any active checkins.
DELETE /checkin
Inputs: no named parameters. Returns: result
delete_comments_by_idADestructiveIdempotent
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_likeADestructiveIdempotent
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_typeCDestructiveIdempotent
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_likeCDestructiveIdempotent
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_idADestructiveIdempotent
Delete a note.
DELETE /notes/{id}
Args: id: The id/slug of the resource.
Inputs: id (required). Returns: result
delete_recommendations_movies_by_idADestructiveIdempotent
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_idBDestructiveIdempotent
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_resetBDestructiveIdempotent
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_idBDestructiveIdempotent
Remove a playback item.
DELETE /sync/playback/{id}
Args: id: ID of the playback entry
Inputs: id (required). Returns: result
delete_users_by_id_blockADestructiveIdempotent
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_followADestructiveIdempotent
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_idBDestructiveIdempotent
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_likeCDestructiveIdempotent
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_idADestructiveIdempotent
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_idBDestructiveIdempotent
Deny follow request.
DELETE /users/requests/{id}
Args: id: Path parameter.
Inputs: id (required). Returns: result
delete_users_saved_filters_by_idBDestructiveIdempotent
Delete saved filter.
DELETE /users/saved_filters/{id}
Args: id: ID of the saved filter
Inputs: id (required). Returns: result
delete_users_settings_plex_connectADestructiveIdempotent
Disconnect Plex.
DELETE /users/settings/plex/connect
Inputs: no named parameters. Returns: result
delete_users_syncs_by_idBDestructiveIdempotent
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_idBDestructiveIdempotent
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_authenticationAIdempotent
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_statusARead-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_daysARead-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_daysARead-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_daysCRead-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_daysCRead-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_daysCRead-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_daysBRead-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_daysBRead-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_daysBRead-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_daysBRead-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_daysCRead-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_daysCRead-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_daysCRead-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_typeCRead-onlyIdempotent
Get certifications.
GET /certifications/{type}
Args: type: Certification media type.
Inputs: type (required). Returns: result
get_comments_by_idARead-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_itemARead-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_likesARead-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_reactionsBRead-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_summaryCRead-onlyIdempotent
Get reaction summary.
GET /comments/{id}/reactions/summary
Args: id: Path parameter.
Inputs: id (required). Returns: result
get_comments_by_id_repliesARead-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_typeBRead-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_trending_by_comment_type_by_typeBRead-onlyIdempotent
Get trending comments.
GET /comments/trending/{comment_type}/{type}
Args: comment_type: Comment type filter. type: Media type filter. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page, can be a number or the value all include_replies: Include replies inline alongside top level comments.
Inputs: type (required), comment_type (required), page, limit, +2 more. Returns: result
get_comments_updates_by_comment_type_by_typeCRead-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_typeARead-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_countryBRead-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_typeCRead-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_typeBRead-onlyIdempotent
Get languages.
GET /languages/{type}
Args: type: Media type to return languages for.
Inputs: type (required). Returns: result
get_lists_by_idCRead-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_sortBRead-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_howCRead-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_movieCRead-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_showBRead-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_seasonCRead-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_showCRead-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_likesARead-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_lists_popular_by_typeBRead-onlyIdempotent
Get popular lists.
GET /lists/popular/{type}
Args: type: List type filter. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter.
Inputs: type (required), page, limit, years, +10 more. Returns: result
get_lists_trending_by_typeBRead-onlyIdempotent
Get trending lists.
GET /lists/trending/{type}
Args: type: List type filter. extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter.
Inputs: type (required), page, limit, years, +10 more. Returns: result
get_movies_by_idARead-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_aliasesBRead-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_sortBRead-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_sortBRead-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_peopleARead-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_ratingsARead-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_countryARead-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_sentimentsCRead-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_statsBRead-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_studiosARead-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_translationsARead-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_videosBRead-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_watchingBRead-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_countryCRead-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_by_id_watchnow_justwatch_links_by_countryBRead-onlyIdempotent
Get movie JustWatch links.
GET /movies/{id}/watchnow/justwatch_links/{country}
Args: country: Path parameter. id: The id/slug of the resource.
Inputs: id (required), country (required). Returns: result
get_movies_collected_by_periodARead-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_periodARead-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_periodBRead-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_periodCRead-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_dateARead-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_dateBRead-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_periodARead-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_idCRead-onlyIdempotent
Get a note.
GET /notes/{id}
Args: id: The id/slug of the resource.
Inputs: id (required). Returns: result
get_notes_by_id_itemBRead-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_idARead-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_sortBRead-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_moviesCRead-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_showsBRead-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_dateBRead-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_dateARead-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_pageARead-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_idARead-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_typeARead-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_exactBRead-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_typeARead-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_idARead-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_aliasesBRead-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_certificationsARead-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_sortBRead-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_episodeARead-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_sortARead-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_episodeBRead-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_peopleBRead-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_collectionARead-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_watchedARead-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_ratingsBRead-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_seasonsCRead-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_seasonARead-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_sortBRead-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_episodeBRead-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_sortBRead-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_sortARead-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_peopleARead-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_ratingsARead-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_statsBRead-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_translationsARead-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_videosBRead-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_watchingBRead-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_countryCRead-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_infoBRead-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_sortBRead-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_peopleBRead-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_ratingsARead-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_statsCRead-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_translationsARead-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_videosBRead-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_watchingCRead-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_seasons_by_season_watchnow_justwatch_links_by_countryCRead-onlyIdempotent
Get season JustWatch links.
GET /shows/{id}/seasons/{season}/watchnow/justwatch_links/{country}
Args: season: Path parameter. country: Path parameter. id: The id/slug of the resource.
Inputs: id (required), season (required), country (required). Returns: result
get_shows_by_id_sentimentsARead-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_statsCRead-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_studiosCRead-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_translationsARead-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_videosCRead-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_watchingCRead-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_countryBRead-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_by_id_watchnow_justwatch_links_by_countryCRead-onlyIdempotent
Get show JustWatch links.
GET /shows/{id}/watchnow/justwatch_links/{country}
Args: country: Path parameter. id: The id/slug of the resource.
Inputs: id (required), country (required). Returns: result
get_shows_collected_by_periodARead-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_periodBRead-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_periodCRead-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_periodBRead-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_dateARead-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_dateARead-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_periodCRead-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_idCRead-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_itemsCRead-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_typeDRead-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_howBRead-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_idBRead-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_typeBRead-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_ratingCRead-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_typeCRead-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_howCRead-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_idARead-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_activitiesCRead-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_typeARead-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_typeBRead-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_howARead-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_sortBRead-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_sortCRead-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_sortCRead-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_sortBRead-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_followersARead-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_followingBRead-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_friendsBRead-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_historyBRead-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_idARead-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_episodesCRead-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_idBRead-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_moviesARead-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_idARead-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_showsBRead-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_idBRead-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_typeBRead-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_listsARead-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_idARead-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_sortCRead-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_howBRead-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_movieCRead-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_showCRead-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_episodeARead-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_showCRead-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_likesARead-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_collaborationsARead-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_monthCRead-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_typeBRead-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_ratingsBRead-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_ratingARead-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_episodesARead-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_moviesARead-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_showsARead-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_listsBRead-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_idCRead-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_statsCRead-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_typeBRead-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_moviesBRead-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_showsBRead-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_watchingCRead-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_howBRead-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_sortARead-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_sortBRead-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_sortCRead-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_sortBRead-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_yearCRead-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_saved_filters_by_sectionBRead-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_idBRead-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_idBRead-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_pausedARead-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_skippedARead-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_typeARead-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_codeCRead-onlyIdempotent
Get watch now sources by country.
GET /watchnow/sources/{countryCode}
Args: country_code: Path parameter.
Inputs: country_code (required). Returns: result
list_certifications_moviesBRead-onlyIdempotent
Get movie certifications.
GET /certifications/movies
Inputs: no named parameters. Returns: result
list_certifications_showsARead-onlyIdempotent
Get show certifications.
GET /certifications/shows
Inputs: no named parameters. Returns: result
list_lists_popularBRead-onlyIdempotent
Get popular lists.
GET /lists/popular
Args: extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter.
Inputs: page, limit, years, genres, +9 more. Returns: result
list_lists_trendingCRead-onlyIdempotent
Get trending lists.
GET /lists/trending
Args: extended: Extended information to include in the response. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter.
Inputs: page, limit, years, genres, +9 more. Returns: result
list_media_anticipatedBRead-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_media_popularBRead-onlyIdempotent
Get popular media.
GET /media/popular
Args: extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items.
Inputs: page, limit, years, genres, +12 more. Returns: result
list_media_trendingBRead-onlyIdempotent
Get trending media.
GET /media/trending
Args: extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items.
Inputs: page, limit, years, genres, +12 more. Returns: result
list_movies_anticipatedBRead-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_boxofficeARead-onlyIdempotent
Get the weekend box office.
GET /movies/boxoffice
Args: extended: Extended information to include in the response.
Inputs: extended. Returns: result
list_movies_hotCRead-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_movies_popularBRead-onlyIdempotent
Get popular movies.
GET /movies/popular
Args: extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items.
Inputs: page, limit, years, genres, +12 more. Returns: result
list_movies_trendingBRead-onlyIdempotent
Get trending movies.
GET /movies/trending
Args: extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items.
Inputs: page, limit, years, genres, +12 more. Returns: result
list_networksBRead-onlyIdempotent
Get networks.
GET /networks
Inputs: no named parameters. Returns: result
list_oauth_authorizeCRead-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_moviesBRead-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_showsBRead-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_anticipatedBRead-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_hotBRead-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_shows_popularBRead-onlyIdempotent
Get popular shows.
GET /shows/popular
Args: extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items.
Inputs: page, limit, years, genres, +12 more. Returns: result
list_shows_trendingARead-onlyIdempotent
Get trending shows.
GET /shows/trending
Args: extended: Extended information to include in the response. watchnow: Use "favorites" for streaming on a favorite service of the user. Use "any" for streaming on any service in the user's country. Use "any_all" for streaming on any service in all countries. Use "free" for streaming for free in the user's country. Use "free_all" for streaming for free in all countries. Use "subscriptions" for streaming on any subscription service (Netflix, Hulu, etc) in the user's country. Use "subscriptions_all" streaming on any subscription service in all countries genres: Query parameter. subgenres: Query parameter. years: Query parameter. ratings: Query parameter. start_date: Query parameter. end_date: Query parameter. runtimes: Query parameter. countries: Query parameter. certifications: Query parameter. page: The page number to retrieve limit: The number of items per page. Defaults and maximums vary by endpoint. When pagination parameters are omitted, a low default limit is applied (often 10). When a limit is provided, it is capped at the endpoint maximum (often 250); higher values are clamped rather than rejected. ignore_watched: Ignore watched items. ignore_collected: Ignore collected items. ignore_watchlisted: Ignore watchlisted items.
Inputs: page, limit, years, genres, +12 more. Returns: result
list_social_recommendations_moviesBRead-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_showsBRead-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_episodesCRead-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_mediaBRead-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_episodesCRead-onlyIdempotent
Get minimal episode collection.
GET /sync/collection/minimal/episodes
Args: available_on: Query parameter.
Inputs: available_on. Returns: result
list_sync_collection_minimal_moviesCRead-onlyIdempotent
Get minimal movie collection.
GET /sync/collection/minimal/movies
Args: available_on: Query parameter.
Inputs: available_on. Returns: result
list_sync_collection_minimal_showsCRead-onlyIdempotent
Get minimal show collection.
GET /sync/collection/minimal/shows
Args: available_on: Query parameter.
Inputs: available_on. Returns: result
list_sync_collection_moviesBRead-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_showsCRead-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_activitiesCRead-onlyIdempotent
Get last activity.
GET /sync/last_activities
Inputs: no named parameters. Returns: result
list_sync_playback_moviesBRead-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_nextBRead-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_nitroBRead-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_watchedBRead-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_teamBRead-onlyIdempotent
Get team members.
GET /team/
Args: extended: Extended information to include in the response.
Inputs: extended. Returns: result
list_users_blockedBRead-onlyIdempotent
Get blocked users.
GET /users/blocked
Inputs: no named parameters. Returns: result
list_users_reactions_commentsCRead-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_requestsCRead-onlyIdempotent
Get follow requests.
GET /users/requests/
Args: extended: Extended information to include in the response.
Inputs: extended. Returns: result
list_users_requests_followingCRead-onlyIdempotent
Get pending following requests.
GET /users/requests/following
Args: extended: Extended information to include in the response.
Inputs: extended. Returns: result
list_users_settingsCRead-onlyIdempotent
Retrieve settings.
GET /users/settings
Args: extended: Extended information to include in the response.
Inputs: extended. Returns: result
list_users_settings_plexBRead-onlyIdempotent
Get Plex settings.
GET /users/settings/plex/
Inputs: no named parameters. Returns: result
list_users_settings_plex_serversARead-onlyIdempotent
Get Plex servers.
GET /users/settings/plex/servers
Inputs: no named parameters. Returns: result
list_users_syncsBRead-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_sourcesBRead-onlyIdempotent
Get watch now sources.
GET /watchnow/sources
Inputs: no named parameters. Returns: result
list_younify_connectionsBRead-onlyIdempotent
Get streaming connections.
GET /younify/connections
Inputs: no named parameters. Returns: result
start_authenticationAIdempotent
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_idAIdempotent
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_idAIdempotent
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_favoritesBIdempotent
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_idBIdempotent
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_watchlistCIdempotent
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_idCIdempotent
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_avatarAIdempotent
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_idBIdempotent
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_idAIdempotent
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_idBIdempotent
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_coverBIdempotent
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_settingsBIdempotent
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_plexBIdempotent
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
Scored across 339 tools
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.
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.
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.
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
Related MCP Connectors
Connect Claude to your Platform7n workspaces: chat, links, work and decks. One-click OAuth.
Connect Claude to your Platform7n workspaces: chat, links, work and decks. One-click OAuth.
Lets Claude, ChatGPT, and Muse read and update your beckett tasks, notes, calendar, and lists.
WHOOP recovery, strain, sleep and workouts in Claude via official WHOOP OAuth. Free, open source.
Related MCP Servers
- AlicenseCqualityBmaintenanceEnables full control of Sonarr from Claude.ai and Claude Code by exposing all 234 v3 API operations as tools for managing media libraries.23523 npmMIT
- AlicenseBqualityBmaintenanceEnables 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.28MIT
- AlicenseAqualityCmaintenanceEnables Claude to read Simkl watch history, log watched items, manage library status, and search titles.14MIT
- AlicenseNot gradedqualityBmaintenanceConnects 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 npmGPL 3.0