Kiss

GET/kiss

Kiss someone. Returns a random anime GIF for the kiss action.

Available pairings

Available pairingsDuo only

ffGirl × Girl

mmBoy × Boy

fmGirl → Boy

mfBoy → Girl

Query parameters

Parameter	Type	Required	Description
pairing	string	No	Filter by pairing. If omitted, returns a random pairing from the available ones above.
type	string	No	Filter by kiss type. Valid values: mouth, forehead, cheek.
nsfw	boolean	No	Filter NSFW content. Defaults to false.

Response fields

Field	Type	Description
action	string	Always "kiss"
typeoptional	string	The returned kiss type
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 (image/gif)
size_bytes	number	File size in bytes

Example request

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

Available type values for /kiss:

• mouth
• forehead
• cheek

To discover available types for this action:

curl https://api.gifukai.com/actions/kiss/types

Aliases

These aliases resolve to kiss — they behave exactly like the real action:

Alias	Behavior
peck	GET /peck → a kiss GIF locked to type cheek

Status codes

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

Try it

API PlaygroundSend

GEThttps://api.gifukai.com/kiss?pairing=

Response

// Hit Send to try the API

Preview

Hit Send to preview

Loading…