Sign in

v1

latestSwagger 2.02026-07-13421625.7 KB
scrobbling

Mark episodes within a show as acquired or watched based on their attributes

To specify a show, supply either tvmaze_id, thetvdb_id or imdb_id. To specify an episode, supply either both season and episode, or airdate.

This endpoint can be used by all users, even without premium.

post/scrobble/shows

Query parameters

tvmaze_idinteger

The show's TVmaze ID

thetvdb_idinteger

The show's TheTVDB ID

imdb_idinteger

The show's IMDB ID

Request body

seasoninteger

The season number

episodeinteger

The episode number

airdatestring date

The episode airdate

marked_atinteger

Epoch timestamp for when the user watched the episode, or 0 for unknown.

{"stackTrail":"components:schemas:MarkType","oasType":"schema","type":"unknown","description":"0 for watched, 1 for acquired, 2 for skipped"}

Response

All episodes were succesfully marked

codeinteger

The HTTP code that corresponds to this item

messagestring

A human-readable error message (in case of error)

errorsobject

A list of validation errors for this item (in case of error)

inputobject

The request data that belonged to this response (in case of error)

resultobject

The resulting created/updated object (in case of success)