Kiss
GET
/kiss Kiss someone. Returns a random anime GIF for the kiss action.
Available pairings
Section titled “Available pairings” Available pairings Duo only
ff Girl × Girl mm Boy × Boy fm Girl → Boy mf Boy → Girl Query parameters
Section titled “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
Section titled “Response fields”| Field | Type | Description |
|---|---|---|
action | string | Always "kiss" |
type optional | string | The returned kiss type |
pairing | string | The pairing of the returned GIF |
anime optional | 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
Section titled “Example request”curl "https://api.gifukai.com/kiss?type=mouth&pairing=fm"Available type values for /kiss:
mouthforeheadcheek
To discover available types for this action:
curl https://api.gifukai.com/actions/kiss/typesStatus codes
Section titled “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
Section titled “Try it” GET https://api.gifukai.com/kiss?pairing=
// Hit Send to try the API Hit Send to preview