Skip to content
GAMPEONCreate
New project

Search GIFs

GET
/v1/gifs
curl --request GET \
--url https://api.gampeon.com/v1/gifs \
--header 'Authorization: Bearer <token>'

Search KLIPY with q, or trending GIFs without it, 24 per page. Accounts under 16 get the strictest content filter. The API asks KLIPY on your behalf without your account ID, and images are delivered through GET /v1/gifs/:id/:size, so your browser never talks to KLIPY. Show “Search KLIPY” in the search field (KLIPY’s attribution rule).

Not available with access tokens.

Rate limit: 300 per hour per account.

q
string

Search words, up to 100 characters. Empty: trending

page
integer
>= 1 <= 20

1 to 20

GIFs

Media typeapplication/json
object
gifs
required
Array<object>
object
id
required

GIF ID, send it as gif with a post or comment

string
title
required
string
url
required

/v1/gifs/…/md

string
width
required
integer
height
required
integer
preview
required
object
url
required

/v1/gifs/…/sm, for the picker

string
width
required
integer
height
required
integer
next
required
One of:

Next page

integer
provider
required

klipy

string

Example generated

{
"gifs": [
{
"id": "example",
"title": "example",
"url": "example",
"width": 1,
"height": 1,
"preview": {
"url": "example",
"width": 1,
"height": 1
}
}
],
"next": 1,
"provider": "example"
}

Error codes: invalid_field

Media typeapplication/json
object
error
required

Machine-readable error code, for example not_found or rate_limited.

string
message

Human-readable detail. Only present for some errors.

string

Example generated

{
"error": "example",
"message": "example"
}

Error codes: unauthorized

Media typeapplication/json
object
error
required

Machine-readable error code, for example not_found or rate_limited.

string
message

Human-readable detail. Only present for some errors.

string

Example generated

{
"error": "example",
"message": "example"
}

Error codes: token_not_allowed

Media typeapplication/json
object
error
required

Machine-readable error code, for example not_found or rate_limited.

string
message

Human-readable detail. Only present for some errors.

string

Example generated

{
"error": "example",
"message": "example"
}

Limit: 300 per hour per account. Error codes: rate_limited

Media typeapplication/json
object
error
required

Machine-readable error code, for example not_found or rate_limited.

string
message

Human-readable detail. Only present for some errors.

string

Example generated

{
"error": "example",
"message": "example"
}

Error codes: gifs_unavailable

Media typeapplication/json
object
error
required

Machine-readable error code, for example not_found or rate_limited.

string
message

Human-readable detail. Only present for some errors.

string

Example generated

{
"error": "example",
"message": "example"
}

Error codes: gifs_unavailable

Media typeapplication/json
object
error
required

Machine-readable error code, for example not_found or rate_limited.

string
message

Human-readable detail. Only present for some errors.

string

Example generated

{
"error": "example",
"message": "example"
}

Report a problem with this pageOther ways to give feedback