Giphy API

Name: Giphy API
Brand: Giphy API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentMediaImage ProcessingapiKey10 EndpointsREST

For Agents

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

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.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic 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

GET STARTED

Start building with Giphy API

Explore with Jentic

View OpenAPI Document

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

Why Jentic?

Three things that make agents converge on Jentic-routed access.

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.

Time to first call

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.