Giphy API
Community OpenAPI document · agent-readyMediaImage ProcessingapiKey10 EndpointsREST
Know of an official OpenAPI document? Contribute it →
For Agents
Search, fetch, and discover GIFs and stickers from Giphy's catalogue using free-text queries, trending lists, or single-ID lookups.
Use for: Search Giphy for GIFs matching 'celebration', Get the current trending GIFs on Giphy, Translate the phrase 'good morning' into a single GIF, Find a random sticker tagged 'dog'
Not supported: Does not handle video transcoding, image generation, or content moderation beyond rating filters - use for searching and fetching Giphy GIFs and stickers only.
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.
Install Jentic One Beta
Connect the Giphy API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Giphy API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fgiphy.com%2Fgiphy" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fgiphy.com%2Fgiphy" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Giphy API.
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
Patterns agents use Giphy API for, with concrete tasks.
★ 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.
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.
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.
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.
Through Jentic, call /gifs/translate with s='congratulations' and return the embed URL for the matched GIF
Key Endpoints
10 endpoints — the giphy api provides search, trending, translate, and random endpoints for gifs and stickers, plus per-asset detail lookups by id.
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
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
Why Jentic?
What agents get from Jentic-routed access to this vendor.
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 isolation
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.
Intent-based discovery
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
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Giphy API through Jentic.
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.
GET STARTED