K
Docs
📺

Find a TV Show

info.showThe AlmanacLook-ups

Finds a TV show by name and brings back its summary, rating, genres, network or streaming service, years on air, poster — and when the next episode airs. Perfect for a /show spell or a channel that tracks what everyone's watching.

When to use this
  • →Next episode: {{show.next}} airs <t:{{show.nextAt}}:R> (both are empty once a show has ended)
  • →Data from TVmaze — {{show.url}} links to the show there

On the canvas

This is what Find a TV Show looks like when you place it on your flow. Each field below is something you configure in the inspector panel.

📺
Find a TV Show
info.show
Look-ups
queryrequired
e.g. {{input.options.show}}
asrequired
show
found
missing
error

Config fields

FieldTypeReqWhat it does
query
e.g. {{input.options.show}}
textyesWhich show 🔎
as
show
textyesSave it as ✨

Sparks this piece adds

After this piece runs, these values are available as sparks in every node downstream.

{{show.name}}stringThe show's name
{{show.summary}}stringWhat it's about
{{show.rating}}numberRating out of 10 (empty when unrated)
{{show.genres}}stringGenres, like Drama, Comedy
{{show.status}}stringRunning, Ended, To Be Determined…
{{show.years}}stringYears on air, like 2022–2026
{{show.network}}stringNetwork or streaming service
{{show.runtime}}numberMinutes per episode
{{show.next}}stringNext episode, like S2E5 · Title (empty when none is scheduled)
{{show.nextAt}}numberWhen it airs, as a Unix time — try <t:…:R>
{{show.last}}stringLatest episode
{{show.lastAt}}numberWhen it aired, as a Unix time
{{show.image}}stringLink to the poster
{{show.url}}stringLink to the show on TVmaze
{{show.imdb}}stringLink to IMDb (when known)
{{show.query}}stringWhat was looked up
{{show.error}}stringWhy it couldn't be looked up

Output ports

foundThe show is in your spark — {{show.name}}, {{show.rating}}
missingNothing matched — {{…query}} says what they asked for
errorCouldn't ask right now (busy or down) — {{…error}} says why
📐

In TypeScript, this would be…

Not something you need to write — just a look at what Kitcord does for you.

TypeScript
const res = await fetch(
  `https://api.tvmaze.com/singlesearch/shows?q=${encodeURIComponent(name)}&embed[]=nextepisode`,
);
if (res.status === 404) return; // Missing ∅
const show = await res.json();
const next = show._embedded?.nextepisode; // {{show.next}}, {{show.nextAt}}
await interaction.editReply(`📺 **${show.name}** — ⭐ ${show.rating.average}`);