TVmaze user API

Tools (44)

Extracted live via the executor SDK.

• auth.getAuthValidate

  If the credentials supplied as HTTP basic are valid, the user's level of premium - if any - is returned.

• auth.postAuthPoll

  Using the token acquired in the start endpoint, you can start polling this endpoint once every 10 seconds.

  When the user has confirmed the authentication request on their end, this endpoint will return the user's API key that you can use in subsequent authenticated endpoints. Note that it'll do so only once, subsequent requests after the initial 200 response will return a 404.

  For as long as the user did not yet confirm their authentication request, this endpoint will return a 403.

• auth.postAuthStart

  If you want to access the TVmaze API on behalf of a user without querying them for their password, use this endpoint.

  To get started, send a POST request containing the user's email address. The response will contain a token, which you can use as input to the poll endpoint. The user will receive an email prompting them to confirm the authentication request.

  Alternatively, if you expect the user to be logged in to TVmaze on the device they are currently interacting with, you can set email_confirmation to false and redirect them to the confirm_url URL. If they are logged in to TVmaze, they will be able to confirm the authentication request instantly.

• followedNetworks.deleteUserFollowsNetworksNetworkId

  Unfollow a network

• followedNetworks.getUserFollowsNetworks

  List the followed networks

• followedNetworks.getUserFollowsNetworksNetworkId

  Check if a network is followed

• followedNetworks.putUserFollowsNetworksNetworkId

  Follow a network

• followedPeople.deleteUserFollowsPeoplePersonId

  Unfollow a person

• followedPeople.getUserFollowsPeople

  List the followed people

• followedPeople.getUserFollowsPeoplePersonId

  Check if a person is followed

• followedPeople.putUserFollowsPeoplePersonId

  Follow a person

• followedShows.deleteUserFollowsShowsShowId

  Unfollow a show

• followedShows.getUserFollowsShows

  List the followed shows

• followedShows.getUserFollowsShowsShowId

  Check if a show is followed

• followedShows.putUserFollowsShowsShowId

  Follow a show

• followedWebchannels.deleteUserFollowsWebchannelsWebchannelId

  Unfollow a webchannel

• followedWebchannels.getUserFollowsWebchannels

  List the followed webchannels

• followedWebchannels.getUserFollowsWebchannelsWebchannelId

  Check if a webchannel is followed

• followedWebchannels.putUserFollowsWebchannelsWebchannelId

  Follow a webchannel

• markedEpisodes.deleteUserEpisodesEpisodeId

  Unmark an episode

• markedEpisodes.getUserEpisodes

  List the marked episodes

• markedEpisodes.getUserEpisodesEpisodeId

  Check if an episode is marked

• markedEpisodes.putUserEpisodesEpisodeId

  Set marked_at to NULL or leave it out to use the current time.

• scrobbling.getScrobbleShowsShowId

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

• scrobbling.postScrobbleEpisodes

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

• scrobbling.postScrobbleShows

  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.

• scrobbling.putScrobbleEpisodesEpisodeId

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

• taggedShows.deleteUserTagsTagId

  Delete a specific tag

• taggedShows.deleteUserTagsTagIdShowsShowId

  Untag a show

• taggedShows.getUserTags

  List all tags

• taggedShows.getUserTagsTagIdShows

  List all shows under this tag

• taggedShows.patchUserTagsTagId

  Update a specific tag

• taggedShows.postUserTags

  Create a new tag

• taggedShows.putUserTagsTagIdShowsShowId

  Tag a show

• votedEpisodes.deleteUserVotesEpisodesEpisodeId

  Remove an episode vote

• votedEpisodes.getUserVotesEpisodes

  List the episodes voted for

• votedEpisodes.getUserVotesEpisodesEpisodeId

  Check if an episode is voted for

• votedEpisodes.putUserVotesEpisodesEpisodeId

  Vote for an episode

• votedShows.deleteUserVotesShowsShowId

  Remove a show vote

• votedShows.getUserVotesShows

  List the shows voted for

• votedShows.getUserVotesShowsShowId

  Check if a show is voted for

• votedShows.putUserVotesShowsShowId

  Set voted_at to NULL or leave it out to use the current time.

• openapi.previewSpec

  Preview an OpenAPI document before adding it as a source

• openapi.addSource

  Add an OpenAPI source and register its operations as tools