GIPHY: 11 reads, one client
Search, trending and random GIFs and stickers. Free API key. Every call below is available over HTTP, through the SDK and as a tool for a coding agent, with the same arguments and the same meter.
What GIPHY can do here
The integration exposes 11 reads, each with a declared input and output schema rather than a page of documentation you would have to translate. Search, trending and random GIFs and stickers. Free API key.
How it authenticates
GIPHY authenticates with a apiKey, supplied per request or stored once against your account and sealed at rest. On our side the same value is read from apiKey when we broker the call for you.
Called by name, not by capability
GIPHY does not currently map onto a vendor-neutral capability, so you call its operations by name. That is the right shape when you genuinely mean this provider — which, for a service with its own model of the world, is most of the time.
- search — read: Search GIFs by keyword.
- trending — read: What is trending on GIPHY now. The connection test.
- random — read: One random GIF, optionally from a tag.
- searchStickers — read: Search stickers — transparent-background GIFs.
- gifById — read: One GIF by its id — the only way to re-fetch renditions for something already chosen.
- gifsByIds — read: Several GIFs by id in one call — the batch form of gifById.
- translate — read: Turn a phrase into the single GIF that best expresses it — GIPHY's sentiment engine, not a keyword search.
- trendingStickers — read: Trending stickers — the transparent-background counterpart of trending.
- randomSticker — read: One random sticker, optionally from a tag.
- searchSuggestions — read: Tag suggestions for a partial search term — type-ahead for a GIF picker.
- trendingSearches — read: What people are searching GIPHY for right now.
Questions
Do I have to bring my own API keys?
You can, and that lane is free for ever — pass your key on the request or store it against your account, and we are one proxy hop. The paid lane is the other direction: we call 226 providers with our credentials so you never register anywhere. Both go through the same client and the same operation names.
What happens to a key I store here?
It is sealed with AES-256-GCM before it reaches the database and is only ever opened to make the call you asked for. It is scoped to your account, it is never logged, and deleting the connection deletes it. For an OAuth provider we hold a refresh token instead, and revoking the link at the provider stops the calls here immediately.
What happens when a provider changes its API?
The operation contract is declared, so a response that no longer matches is a refusal rather than a silently wrong answer. The contract does not coerce types — a field declared a number that arrives as a string is rejected at the edge, on the way in and on the way out.