Get watchlist

Titles on your watchlist with the date each was added.

GET https://cotlet.dev/api/v1/trakt/watchlist

read

Returns your watchlist in pages, with the type, title, year and the date each item was added. Filter by type to see only movies or only shows. Use it before adding, so you do not add a title twice.

Parameters

Parameters: get_watchlist
NameTypeDescription
type string string Only this kind of title: 'movies', 'shows', 'seasons' or 'episodes'. Default: all.
page integer integer Page number, starting at 1. Default: 1.
limit integer integer Items per page. Default: 20.

Request

cURL
curl https://cotlet.dev/api/v1/trakt/watchlist \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("trakt", "get_watchlist")
Node.js
const result = await cotlet.call('trakt', 'get_watchlist');
CLI
cotlet call trakt get_watchlist

Example response

JSON

{
  "items": [
    {
      "type": "show",
      "trakt_id": 401992,
      "title": "Slow Horses",
      "year": 2022,
      "added_at": "2026-10-02T18:20:00Z"
    },
    {
      "type": "movie",
      "trakt_id": 548210,
      "title": "Past Lives",
      "year": 2023,
      "added_at": "2026-09-28T09:05:00Z"
    }
  ],
  "page": 1,
  "total_pages": 1
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.