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

Giphy api_key values are stored encrypted in the Jentic vault (MAXsystem). Agents receive a scoped execution token — the raw key never enters the agent's prompt context or logs.

Intent-based discovery

Agents search by intent (e.g. 'find a gif for a phrase') and Jentic returns the matching Giphy operation with its query parameter schema, so the agent can call /gifs/search or /gifs/translate without reading docs.

Time to first call

Direct Giphy integration: 2-4 hours for key handling, query construction, and rendition selection. Through Jentic: under 15 minutes — search, load, execute.

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 the encrypted MAXsystem vault 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.