GIFDB Public API

Search and retrieve GIFs and stickers through a stable JSON API.

Base URL https://gifdb.com/api/v1

Authentication

Send your partner API key in the X-API-Key header. The health endpoint is available without a key. To request API access, contact GIFDB.

curl -H "X-API-Key: YOUR_KEY" \
  "https://gifdb.com/api/v1/search?q=celebration&type=gif&limit=20"

Read-only endpoints

Endpoint	Purpose
`GET /health`	API availability and authentication status.
`GET /trending`	Trending GIFs or stickers.
`GET /home`	Combined home feed.
`GET /categories`	Popular keyword categories.
`GET /keyword/{slug}`	Media belonging to one keyword.
`GET /search?q={query}`	Search GIFs or stickers.
`GET /item/{slug}`	Retrieve one media item.

Common parameters

type=gif|sticker selects the media type.
limit=1..100 controls page size.
offset=0.. selects the result offset.
sort=newest|hot is supported by keyword listings.

Machine-readable resources

Errors and rate limits

Errors use JSON with ok, error, and message fields. A 401 means the API key is missing or invalid; 429 means the request rate limit was exceeded. Rate-limit details are returned in the response headers.