Introduction

Gifukai is a free, open-source REST API that serves high-quality anime reaction GIFs. It’s designed specifically for Discord bots and apps that need anime interaction commands like /hug, /kiss, /pat, and more.

What makes it different?

Pairing support. This is the only GIF API that lets you specify the gender of the characters in each GIF. When a user runs /hug @someone in Discord, your bot can request the correct pairing (e.g., ff for girl hugging girl, mf for boy hugging girl) so the GIF matches the users.

Quick start

Make a GET request to get a random anime GIF:

curl https://api.gifukai.com/hug

With a specific pairing:

curl https://api.gifukai.com/kiss?pairing=fm

Response:

{
  "action": "kiss",
  "pairing": "fm",
  "anime": "Tonikaku Kawaii",
  "url": "https://cdn.gifukai.com/kiss/abc123.gif",
  "filename": "abc123.gif",
  "content_type": "image/gif",
  "size_bytes": 695000
}

Pairings

Code	Description
f	Solo Girl
m	Solo Boy
ff	Girl × Girl
mm	Boy × Boy
fm	Girl → Boy
mf	Boy → Girl

If you don’t specify a pairing, a random GIF from any pairing is returned.

Types

Some actions support a type filter.

Use GET /actions and GET /actions/{action}/types to discover support and available values dynamically.

Example:

curl "https://api.gifukai.com/kiss?type=mouth"

Using with a Discord bot

Here’s a minimal example with discord.js:

const { EmbedBuilder } = require('discord.js');

async function hugCommand(interaction) {
  const target = interaction.options.getUser('user');
  const pairing = 'ff'; // or resolve from user genders

  const res = await fetch(
    `https://api.gifukai.com/hug?pairing=${pairing}`
  );
  const data = await res.json();

  const embed = new EmbedBuilder()
    .setDescription(`**${interaction.user.displayName}** hugged **${target.displayName}**!`)
    .setImage(data.url)
    .setColor(0xd946ef);

  interaction.reply({ embeds: [embed] });
}

Next steps

• Browse the Endpoints documentation for all public API endpoints
• Explore each Action to see available pairings and try the live playground
• Star the project on GitHub
• Sponsor the project to help keep it running