Your data .md

Favorites

Read, add, and remove favorites for the signed-in user.

Reading favorites#

curl -H "Authorization: Bearer $TOKEN" \
  "https://flicklist.tv/api/v3/sync/favorites"

const res = await fetch('https://flicklist.tv/api/v3/sync/favorites', {
  headers: { Authorization: `Bearer ${token}` }
});
const favorites = await res.json();

import requests
r = requests.get(
    "https://flicklist.tv/api/v3/sync/favorites",
    headers={"Authorization": f"Bearer {token}"},
)
favorites = r.json()

[
  {
    "title": "The Shawshank Redemption",
    "year": 1994,
    "media_type": "movie",
    "favorited_at": "2026-05-14T02:10:33.000Z",
    "ids": { "fldb": "flm_7d3a95e0", "slug": "the-shawshank-redemption", "tmdb": 278, "imdb": "tt0111161", "tvdb": null, "anilist": null }
  }
]

Adding favorites#

POST /v3/sync/favorites adds up to 1000 items in one batch. Build each item's ids block per The ids object.

{ "items": [ { "ids": { "tmdb": 278 }, "media_type": "movie" } ] }

Upsert semantics apply: an item already favorited still counts as added, since the call still succeeded idempotently.

{ "added": 1, "not_found": [] }

Removing favorites#

DELETE /v3/sync/favorites takes the same body shape and removes the matching entries.

{ "removed": 1, "not_found": [] }