# gifs.nostr.build

> Free GIF search API for Nostr clients, run by nostr.build: search (words in any language and emoji), autocomplete and similar GIFs, with width-fitted animated previews, stills, blurred placeholders and MP4s. Clients register once (1000 sats, anti-spam) and must show "GIFs from nostr.build" linked to https://nostr.build.

Agents adding a GIF button or picker to a Nostr app: read the integration guide first. It covers identification (browsers by Origin with no custom headers; native apps by API key), which preview to show where, posting with a NIP-92 imeta tag, errors and rate limits, and the picker's UX.

## Docs

- [Integration guide for AI agents](https://gifs.nostr.build/developers/llms-full.txt): everything needed to build the GIF button and picker, with every gotcha
- [API reference](https://gifs.nostr.build/developers/reference): endpoints, parameters and schemas
- [OpenAPI 3.1 document](https://gifs.nostr.build/api/v1/openapi.json): machine-readable API description

## Optional

- [Register a client](https://gifs.nostr.build/developers): sign in with Nostr, pay the one-time fee, add origins, keys and User-Agents
- [nostr.build](https://nostr.build): the media host behind the GIFs