K
Docs
🌸

Find an Anime

info.animeThe AlmanacLook-ups

Finds an anime by name — English or Japanese titles both work — and brings back its synopsis, score out of 10, episode count and length, status, type, age rating, poster and banner. Adult titles are never returned.

When to use this
  • →{{anime.romaji}} and {{anime.japanese}} hold the other titles
  • →Data from Kitsu — {{anime.url}} links to the anime there

On the canvas

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

🌸
Find an Anime
info.anime
Look-ups
queryrequired
e.g. {{input.options.anime}}
asrequired
anime
found
missing
error

Config fields

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

Sparks this piece adds

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

{{anime.title}}stringTitle (English when there is one)
{{anime.romaji}}stringJapanese title in English letters
{{anime.japanese}}stringJapanese title
{{anime.synopsis}}stringWhat it's about
{{anime.score}}stringScore out of 10, like 8.9
{{anime.episodes}}numberNumber of episodes
{{anime.length}}numberMinutes per episode
{{anime.status}}stringFinished, Ongoing, Upcoming…
{{anime.type}}stringTV, Movie, OVA…
{{anime.year}}numberYear it started
{{anime.age}}stringAge rating
{{anime.image}}stringLink to the poster
{{anime.banner}}stringLink to a wide banner
{{anime.url}}stringLink to it on Kitsu
{{anime.query}}stringWhat was looked up
{{anime.error}}stringWhy it couldn't be looked up

Output ports

foundThe anime is in your spark — {{anime.title}}, ⭐ {{anime.score}}
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://kitsu.app/api/edge/anime?filter[text]=${encodeURIComponent(name)}&page[limit]=1`,
);
const anime = (await res.json()).data[0]?.attributes;
if (!anime) return; // Missing ∅
const score = (Number(anime.averageRating) / 10).toFixed(1); // {{anime.score}}
await interaction.editReply(`🌸 **${anime.titles.en ?? anime.canonicalTitle}** · ⭐ ${score}`);