Get Random GIF

GET/{action}

Returns a random anime GIF for the given action. This is the primary endpoint you’ll use in your Discord bot or application.

See the Actions section for a dedicated page per action with available pairings and a live playground.

{action} can be a real action or an alias — GET /meow resolves to nya, and a type-locked alias like GET /peck returns a kiss with type cheek (any ?type= you pass is ignored for type-locked aliases).

Query parameters

Parameter	Type	Required	Description
pairing	string	No	Filter by character pairing (f, m, ff, mm, fm, mf). If omitted, returns a random pairing.
type	string	No	Filter by action type variant (for example: /kiss?type=mouth). Only valid for actions that are fully typed.
nsfw	boolean	No	Filter NSFW content. Defaults to false.

Use GET /actions/{action}/types to discover whether an action supports type and which values are available.

Response fields

Field	Type	Description
action	string	The action type (e.g. hug, kiss, pat)
typeoptional	string	Type variant of the returned GIF
pairing	string	The pairing of the returned GIF
anime	string	The anime the GIF is from
url	string	Direct URL to the GIF on the CDN
filename	string	The filename of the GIF
content_type	string	MIME type (e.g. image/gif)
size_bytes	number	File size in bytes

Example request

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

Example response

{
  "action": "kiss",
  "type": "mouth",
  "pairing": "fm",
  "anime": "Date A Live",
  "url": "https://cdn.gifukai.com/kiss/61178dc2.gif",
  "filename": "61178dc2.gif",
  "content_type": "image/gif",
  "size_bytes": 391483
}

Status codes

Status	Description
200	Successfully returned a random GIF
400	Invalid pairing/type parameter
404	No GIFs found for the given action/pairing combination
500	Internal server error