How do I connect TVmaze to Lodol?

Authenticate TVmaze once from your workspace and every action and trigger it supports becomes available to drop into a workflow. There is no glue code to write or maintain.

All integrations

TVmaze

Film, TV & Fandom

Look up TV shows, episodes, seasons, cast, crew, and air schedules on TVmaze, and, with a TVmaze account, follow shows, tag them, vote, and track what you have watched. The whole catalogue is free and needs no API key; add your username and key only for the account actions.

Get Started Browse all integrations

55 actions

Actions

Steps your workflow can run in TVmaze.

Search showsSearch TVmaze for TV shows by name and get back each match with its id, network, genres, status, rating, and summary. Use the id with the other actions.

Find one showFind the single show TVmaze thinks a name means, without picking from a list. Returns one show or none; check 'found' before using it. Two shows with the same name (Top Gear) make which one comes back undefined, so use Search shows when that matters.

Look up a show by IMDb or TheTVDB idFind a TVmaze show from its id on another service: IMDb, TheTVDB or TVRage. Use this to map a catalogue you already hold onto TVmaze without matching on names. Returns one show or none.

Search peopleSearch TVmaze for actors and crew by name and get back each match with their id, country, birthday, and headshot. Use the id with the credit actions to see what they have worked on.

Get the TV scheduleList the TV episodes airing in a country on a given day, each with the show it belongs to. Covers broadcast and cable plus country-specific streaming; for Netflix and other global services use Get the streaming schedule.

Get the streaming scheduleList the episodes released on streaming services on a given day. TVmaze separates services available in one country (Hulu, Sky Go) from global ones (Netflix, Prime Video); choose which you want with Scope.

Get the full future scheduleList every future episode TVmaze knows about, anywhere in the world, filtered to the country and dates you want. This is a large, slow response that TVmaze caches for 24 hours; use Get the TV schedule for a single day. Reports how many episodes matched before the limit was applied.

Get a showGet one TV show's full details by its TVmaze id, including network, genres, air schedule, rating, summary, its IMDb id, and which episode aired last and which airs next.

Get a show's episodesList every episode of a show in airing order, with season and episode numbers, air dates, ratings, and synopses.

Get a show's seasonsList a show's seasons in order, each with its episode count, premiere and end dates, and the network that carried it. Use a season's id with Get a season's episodes.

Get a season's episodesList the episodes in one season, specials included. Can also bring back each episode's guest cast in the same request, which is far cheaper than asking per episode. Takes a season id, not a show id; get one from Get a show's seasons.

Get an episode by numberGet one episode of a show by its season and episode number, without pulling the whole episode list. Returns nothing if that episode does not exist; check 'found', which is how you tell whether next week's episode has been listed yet.

Get a show's episodes by dateList the episodes of one show that aired on a given date. Built for daily shows (talk shows, soaps, news) where nobody refers to an episode by season and number. A day with nothing on it comes back empty rather than failing.

Get a show's castList a show's main cast, each performer with the character they play, ordered by how much the character appears. Marks roles played as themselves and voice-only roles.

Get a show's crewList a show's main crew, each with the job they did: creator, executive producer, composer and so on.

Get a show's other titlesList the other names a show goes by. An entry with no country is an alternative title at home; one with a country is what the show is called there. Useful for matching titles from a foreign catalogue.

Get a show's imagesList every image TVmaze holds for a show (posters, banners, backgrounds and typography) at full size, and at medium size where one exists. The image marked 'main' is the show's primary one of that kind.

Get a show's alternate episode ordersList the alternate episode orderings a show has: DVD order, a broadcaster's own numbering, a streaming re-cut. Use a list's id with Get an alternate episode order.

Get an alternate episode orderList the episodes in one alternate ordering, each mapped back to the episode TVmaze numbers normally, which is what lets a DVD episode number be turned into the broadcast one.

List all showsRead one page of the whole TVmaze catalogue, 250 shows to a page, for building or refreshing a local copy. Pages are numbered by id, not position, so nothing shuffles between runs: resume at floor(last id / 250) and step forward until 'has more' is false.

Get an episodeGet one episode by its TVmaze id, together with the show it belongs to. Use it to turn an episode id from the schedule, or from a marked-episode list, back into something with a title and a show attached.

Get an episode's guest castList the guest cast of one episode: the performers who appear in it but are not part of the show's main cast.

Get an episode's guest crewList the guest crew of one episode, most often the director and writers credited on that episode alone.

Get a personGet one person's details by their TVmaze id: name, country, birthday, and headshot.

Get a person's acting creditsList the shows a person has been cast in, each with the character they played. Both the show and the character come back in full, so no follow-up lookups are needed.

Get a person's crew creditsList the shows a person has crewed on, each with the job they did. The show comes back in full.

Get a person's guest appearancesList the individual episodes a person guest-starred in, each with the episode and the character. This is per episode, where Get a person's acting credits is per show.

List all peopleRead one page of every person in the TVmaze database, 1000 to a page. Paged by id exactly like List all shows, so the same resume rule applies.

Get recently changed showsList the shows TVmaze changed recently, most recent first, so a local copy can be refreshed without re-reading the catalogue. A show counts as changed when anything under it changes, an episode or an image included.

Get recently changed peopleList the people TVmaze changed recently, most recent first. A person counts as changed when their own details change and also when a credit involving them is added or removed.

Check TVmaze credentialsCheck that this connection's TVmaze username and API key work, and report whether the account has Premium. Worth running first in any workflow that uses the account actions: a wrong key and a lapsed subscription otherwise both surface as a failure on whichever action happens to run first.

Start a TVmaze authentication requestAsk TVmaze to start authenticating a user by email, so you can get their API key without ever handling their password. TVmaze emails them a confirmation link; once they confirm, Poll an authentication request returns the key. Turn the email off to get a URL to send them to instead.

Poll a TVmaze authentication requestCheck whether a user has confirmed an authentication request, and collect their API key once they have. Poll no faster than once every ten seconds. TVmaze hands the key over exactly once, so store it on the first success; polling again answers as expired. The key lands in this step's result and therefore in the run log: write it to a connection, not to a message or a sheet.

Mark an episodeMark an episode as watched, acquired or skipped on your TVmaze account. Requires a TVmaze account.

Unmark an episodeRemove an episode's mark from your TVmaze account. An episode that was not marked reports removed as false rather than failing, so this is safe to run over a list. Requires TVmaze Premium.

Check if an episode is markedCheck whether one episode is marked on your TVmaze account, and how. Not marked comes back as marked false, not as a failure. Requires TVmaze Premium.

List marked episodesList the episodes marked on your TVmaze account. Narrow it to one show with Show ID; without that it is every episode you have ever marked, which on a long-standing account is thousands. Requires TVmaze Premium.

List marked episodes for a showList what you have marked for one show: watched, acquired, skipped, or all three. This is the version of the marked-episode list that works without Premium, which is why it takes a show rather than offering the lot. Requires a TVmaze account.

Mark many episodesMark a batch of episodes by their TVmaze episode ids in one request. TVmaze judges each entry separately, so the result splits into marked and failed rather than the whole batch succeeding or failing together; check 'failed count'. Requires a TVmaze account.

Mark episodes of a show by numberMark episodes of one show using season and episode numbers, or air dates, instead of TVmaze episode ids, and name the show by its TVmaze, TheTVDB or IMDb id. This is the action for importing a watch history from somewhere else, because nothing has to be resolved to a TVmaze id first. Requires a TVmaze account.

List what you followList the shows, people, networks or streaming services your TVmaze account follows. Each row comes back with the name and the full record, not just an id, so it can be used or reported directly. Requires TVmaze Premium.

Check if you follow somethingCheck whether your TVmaze account follows one show, person, network or streaming service. Not followed comes back as followed false, not as a failure. Requires TVmaze Premium.

Follow somethingFollow a show, person, network or streaming service on your TVmaze account. Following something already followed is not an error, so a sync workflow need not check first. Requires TVmaze Premium.

Unfollow somethingStop following a show, person, network or streaming service. Something that was not followed reports removed as false rather than failing. Requires TVmaze Premium.

List tagsList the tags on your TVmaze account. Tags are your own labels for grouping shows. Requires TVmaze Premium.

Create a tagCreate a new tag on your TVmaze account. Requires TVmaze Premium.

Rename a tagRename one of your TVmaze tags. The shows under it are untouched. Requires TVmaze Premium.

Delete a tagDelete one of your TVmaze tags. This removes the tag itself; the shows that carried it are not otherwise affected. Requires TVmaze Premium.

List shows under a tagList the shows filed under one of your TVmaze tags, each in full rather than as a bare id. Requires TVmaze Premium.

Tag a showFile a show under one of your TVmaze tags. Requires TVmaze Premium.

Untag a showTake a show out of one of your TVmaze tags. A show that was not tagged reports removed as false rather than failing. Requires TVmaze Premium.

List your votesList the votes your TVmaze account has cast, on shows or on episodes. Show votes come back with the show attached; episode votes carry the episode id only, which is TVmaze's own limit. Requires TVmaze Premium.

Check your voteCheck whether your TVmaze account has voted for one show or episode, and with what. Never voted comes back as voted false. Requires TVmaze Premium.

Vote for a show or episodeCast a vote from 1 to 10 for a show or an episode on your TVmaze account. Voting again replaces your previous vote. Requires TVmaze Premium.

Remove your voteRemove your TVmaze vote from a show or an episode. Nothing to remove reports removed as false rather than failing. Requires TVmaze Premium.