canonical: https://jentic.com/apis/giphy.com/giphy

# Giphy API

The Giphy API provides search, trending, translate, and random endpoints for GIFs and stickers, plus per-asset detail lookups by ID. Agents can power chat reactions, social posts, and creative tools by pulling animated content matched to free-text queries or moods. Authentication is a single api_key query parameter, and rate limits scale from a developer key to higher production tiers.

## For AI agents

Search, fetch, and discover GIFs and stickers from Giphy's catalogue using free-text queries, trending lists, or single-ID lookups.

## Scope

Does not handle video transcoding, image generation, or content moderation beyond rating filters - use for searching and fetching Giphy GIFs and stickers only.

## Capabilities

- Search the Giphy GIF catalogue with free-text queries via /gifs/search
- Pull the current trending GIFs feed with /gifs/trending
- Translate a phrase or mood into a single best-match GIF via /gifs/translate
- Fetch a random sticker filtered by tag from /stickers/random
- Look up a single GIF by ID for embed metadata and rendition URLs
- Power chat reactions and social compose surfaces with curated animated content

## Use cases

### Chat Reaction Picker

Add a Giphy-powered reaction picker to a chat or messaging product. The agent calls /gifs/search with the user's typed query, returns the small or fixed_height rendition URLs, and the client renders an inline grid the user can pick from. Trending and random endpoints back the empty-state experience.

Example prompt: Call /gifs/search with q='thumbs up' and limit=10, then return the fixed_height URL of the top result

### Social Compose Suggestions

When a user is composing a social post, suggest a matching GIF based on the post text. /gifs/translate takes a phrase and returns one strongly-matched GIF, and /gifs/trending fills the suggestion strip when no query has been entered yet.

Example prompt: Call /gifs/translate with s='ship it' and return the original-rendition URL plus title for the suggested GIF

### Creative Content Discovery

Build a discovery feed for designers or marketers that mixes trending GIFs and stickers. The agent paginates /gifs/trending and /stickers/random, deduplicates by id, and surfaces each asset with its rating and source URL so the user can credit creators.

Example prompt: Fetch the first 25 trending GIFs from /gifs/trending and return id, title, and rating for each

### AI Agent Visual Reply

Let an AI agent return a GIF instead of plain text when the user asks for an emotional or celebratory response. Through Jentic the agent issues an intent like 'find a celebratory gif', Jentic resolves /gifs/translate with the agent's API key, and the response feeds straight back into the chat surface.

Example prompt: Through Jentic, call /gifs/translate with s='congratulations' and return the embed URL for the matched GIF

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | /gifs/search | Search GIFs by free-text query |
| GET | /gifs/trending | List currently trending GIFs |
| GET | /gifs/translate | Translate a phrase into a single best-match GIF |
| GET | /gifs/random | Return one random GIF, optionally filtered by tag |
| GET | /gifs/{gifId} | Fetch a single GIF by its Giphy ID |
| GET | /stickers/search | Search stickers by free-text query |
| GET | /stickers/trending | List currently trending stickers |
| GET | /stickers/random | Return one random sticker, optionally filtered by tag |

## Key resources

- **GIFs** — Search, trending, translate, random, and single-ID lookups for GIFs
- **Stickers** — Search, trending, translate, and random endpoints for stickers

## Why Jentic

- **Setup:** Wiring the Giphy API by hand means appending your api_key to the query string of every request to api.giphy.com and formatting search and rating parameters yourself. Through Jentic you install once, import the Giphy API from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** Giphy is read-only and puts the gif id in the URL path (/gifs/{gifId}), so a rule can pin your agent to fetching one GIF by id. You choose the operations it may call, and this API exposes only searches and lookups, with no write or destructive actions to include.
- **Credential handling:** Your Giphy api_key is stored once, encrypted, by your own Jentic One instance and injected at execution time, which matters because it rides in the query string. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'find a GIF for a phrase' or 'get a trending sticker', and Jentic returns the matching Giphy operation with its query-parameter schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **OpenAI API** — Use language models to choose or describe Giphy results in agent workflows
- **ElevenLabs API** — Voice generation that pairs with Giphy visuals in multimodal agent outputs
- **Slack Web API** — Post Giphy results directly into Slack channels via chat.postMessage

## FAQ

### What authentication does the Giphy API use?

Giphy uses an api_key query parameter on every request. You generate the key from the Giphy developers dashboard. Through Jentic the key is held in your encrypted Jentic One instance and the raw secret never appears in the agent's prompt context.

### Can I search GIFs by phrase with the Giphy API?

Yes. Call GET /gifs/search with q set to the search phrase and an optional limit and offset for pagination. The response returns matching GIFs with rendition URLs, ratings, and the originating source URL for attribution.

### What are the rate limits for the Giphy API?

Beta keys are limited to 100 requests per hour and 1,000 per day. Production keys, granted after Giphy reviews your app, raise the cap into the tens of thousands per day. Exceeding the cap returns HTTP 429; back off and retry after the window resets.

### How do I find a GIF for a specific phrase through Jentic?

Search Jentic for 'translate phrase to gif', load the GET /gifs/translate schema, and execute with s set to the phrase. The response returns one best-match GIF with embed URLs you can drop into a chat, email, or social post.

### Can I get trending GIFs and stickers from the Giphy API?

Yes. GET /gifs/trending and GET /stickers/trending return the currently trending feeds, paginated via limit and offset. Use rating to constrain results to g, pg, pg-13, or r so the content matches your audience.

### Is the Giphy API free?

Yes for non-commercial and standard product integrations. Commercial uses such as advertising or syndication require a separate agreement with Giphy, but the developer tier with a 1,000-request daily cap is free to obtain and use.

### Can I limit what my agent is allowed to do with the Giphy API?

Yes. Because you run Jentic One yourself, your own rules decide which Giphy operations and credentials the agent may use. The Giphy API is read-only and exposes only searches and lookups, so you can allow just the calls you need, such as GET /gifs/search or GET /gifs/translate, and leave out the rest. Since the GIF id sits in the URL path at /gifs/{gifId}, a rule can even pin the agent to fetching a single GIF by id, and there are no write or destructive operations to expose.