Your data .md

Watched shows & movies

Fetch the complete watched-content collections for the signed-in user: shows rolled up by season and episode, movies as a flat list.

Watched shows#

GET /v3/sync/watched/shows returns one entry per show, newest watched first, nested into seasons and episodes.

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

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

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

Each show carries its own plays and last_watched_at, totaled across every episode, then a seasons array. Specials (season 0) never appear, and an episode you hid from your history stays out of the list.

[
  {
    "show": {
      "title": "Breaking Bad",
      "year": 2008,
      "ids": { "fldb": "flt_9f2c8a1b", "slug": "breaking-bad", "tmdb": 1396, "imdb": "tt0903747", "tvdb": 81189, "anilist": null }
    },
    "plays": 62,
    "last_watched_at": "2026-05-14T02:10:33.000Z",
    "reset_at": null,
    "seasons": [
      {
        "number": 1,
        "episodes": [
          { "number": 1, "plays": 1, "last_watched_at": "2026-01-02T03:00:00.000Z" }
        ]
      }
    ]
  }
]

reset_at is reserved for a future rewatch-reset feature. It's always null today.

Watched movies#

GET /v3/sync/watched/movies returns a flat list with play counts, newest watched first.

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