Serials Watched
Endpoint
Section titled “Endpoint”GET /api/public/:username/serials/watched?limit=50Returns TV series the user has explicitly marked as fully watched. For series that are started but not finished, see Serials Currently Watching.
Path params
Section titled “Path params”| Param | Type | Required | Description |
|---|---|---|---|
username | string | yes | Interis username to resolve |
Query params
Section titled “Query params”| Param | Type | Default | Max | Description |
|---|---|---|---|---|
limit | number | 50 | 200 | Number of watched series to return |
Response
Section titled “Response”[ { "tmdbId": 1396, "title": "Breaking Bad", "posterPath": "/gg40uwtwFcYRL5O4YKwtqqMK5AY.jpg", "backdropPath": "/tsRy63Mu5cu8etL1X7ZLyf7UP1M.jpg", "firstAirYear": 2008, "numberOfSeasons": 5, "numberOfEpisodes": 62, "mediaType": "tv", "lastInteractionAt": "2026-01-10T12:00:00.000Z" }]- “Watched” here is the explicit series-level flag set when a user marks the whole series watched — the same flag used elsewhere in the app (independent of per-episode tracking). It is not derived from episode-completion counts.
- Sorted by
lastInteractionAtdescending (most recently marked watched first). - Does not include per-season/episode progress. For that level of detail on one specific series, see Serials Progress.
Empty state behavior
Section titled “Empty state behavior”Returns [] when the user hasn’t marked any series fully watched.
Error behavior
Section titled “Error behavior”404when the user does not exist.429when the public rate limit is exceeded.500for unexpected server errors.
Examples
Section titled “Examples”const res = await fetch('https://api.interis.gorkemkaryol.dev/api/public/your_username/serials/watched?limit=20');if (!res.ok) throw new Error(`Serials Watched failed: ${res.status}`);
const watched = await res.json();curl "https://api.interis.gorkemkaryol.dev/api/public/your_username/serials/watched?limit=20"Related: Movies Watched · Serials Currently Watching