📺
Find a TV Show
info.showThe AlmanacLook-upsFinds 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.
📺Look-ups
Find a TV Show
info.showqueryrequired
e.g. {{input.options.show}}
asrequired
show
found
missing
error
Config fields
| Field | Type | Req | What it does |
|---|---|---|---|
querye.g. {{input.options.show}} | text | yes | Which show 🔎 |
asshow | text | yes | Save 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 upOutput 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}`);More Look-ups pieces