Add to watchlist
Add movies and shows to your watchlist in one call.
POST https://cotlet.dev/api/v1/trakt/watchlists
write
Adds the given titles to your watchlist. A show on its own adds just the show. Titles already on the watchlist are counted, not added twice, and titles Trakt cannot match come back in not_found. The call fails with an account-limit error if the watchlist is full. It reaches no one and remove_from_watchlist undoes it, so it needs no confirmation.
Parameters
| Name | Type | Description |
|---|---|---|
| items array required | array | Titles to change. Each item is an object: type ('movie', 'show', 'season' or 'episode'), title and year, or trakt_id from search_titles. Seasons and episodes also take season and episode numbers. add_to_history also takes watched_at, rate_titles takes rating. |
Request
curl -X POST https://cotlet.dev/api/v1/trakt/watchlists \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"items":[{"type":"movie","title":"Past Lives","year":2023},{"type":"show","title":"Slow Horses","year":2022},{"type":"movie","title":"Perfect Days","year":2023}]}'result = client.call("trakt", "add_to_watchlist", {"items":[{"type":"movie","title":"Past Lives","year":2023},{"type":"show","title":"Slow Horses","year":2022},{"type":"movie","title":"Perfect Days","year":2023}]})const result = await cotlet.call('trakt', 'add_to_watchlist', {"items":[{"type":"movie","title":"Past Lives","year":2023},{"type":"show","title":"Slow Horses","year":2022},{"type":"movie","title":"Perfect Days","year":2023}]});cotlet call trakt add_to_watchlist --data '{"items":[{"type":"movie","title":"Past Lives","year":2023},{"type":"show","title":"Slow Horses","year":2022},{"type":"movie","title":"Perfect Days","year":2023}]}'Example response
{
"added": {
"movies": 2,
"shows": 1
},
"already_on_watchlist": 0,
"not_found": []
}