TVtvmaze
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

Request

  • Base URL
    https://api.tvmaze.com/v1
  • Auth
    HTTP basic

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.

typeunknown

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)

Changes

No recorded changes to this operation across all 1 revision of this API.