For Agents
Search and discover GIFs and stickers from Tenor, get suggestions and trending terms, and register shares — through 7 endpoints under tenor.googleapis.com/v2.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Tenor GIF 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 | shStep 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 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.
What an agent can do with Tenor GIF API.
Search Tenor for GIFs and stickers matching a query
Fetch the featured GIF set Tenor surfaces by default
List categories of GIFs to power a browse UI
Autocomplete a partial query for in-product GIF pickers
GET STARTED
Use for: Search Tenor for a GIF matching the phrase 'happy friday', I want to fetch the current featured GIFs for a chat app home screen, List Tenor categories so a user can browse rather than search, Autocomplete a partial query as the user types in a GIF picker
Not supported: Does not handle GIF upload, image-to-GIF conversion, or video transcoding — use for searching, browsing, suggesting, and registering shares of existing Tenor GIFs and stickers only.
Jentic publishes the only available OpenAPI specification for Tenor GIF API, keeping it validated and agent-ready. The Tenor GIF API v2 provides 7 endpoints for searching, discovering, and sharing GIFs and stickers from Google's Tenor library, including search, featured, categories, autocomplete, search suggestions, trending terms, and share registration. The API key is sent as a 'key' query parameter and the base URL is tenor.googleapis.com/v2, making it suitable for chat apps, in-product GIF pickers, and AI agents that want to express tone with media.
Get search suggestions to broaden a user's intent
Read trending search terms for cultural moment surfacing
Register that a specific GIF was shared so it ranks better in search
Patterns agents use Tenor GIF API for, with concrete tasks.
★ In-App GIF Picker
Chat and collaboration apps embed Tenor's GIF library by calling /search for the user's query, /autocomplete as they type, and /featured when the picker first opens. The result is a familiar picker experience without hosting media or moderating the GIF corpus.
On a GIF picker open, call /featured and render the result; on each keystroke, call /autocomplete with the current query string.
AI Chatbot Tone with GIFs
AI chatbots that want to add tone and personality to replies use Tenor to fetch a relevant GIF. /search returns ranked results for a phrase like 'thinking face' or 'celebration', and /registershare lifts the GIF in future searches by signalling that it was actually used.
After a positive sentiment response, search Tenor for 'high five', pick the top result, and register a share event.
Cultural Moment Dashboards
Marketing teams pull /trending_terms and /categories to spot rising cultural moments and align campaign creative. Combined with /search the data set lets a team move from a trending term to a candidate set of GIFs in one workflow.
Pull /trending_terms every 6 hours and post the top 5 terms with a sample GIF from /search for each into a marketing channel.
Agent Media Enrichment via Jentic
An AI agent that already produces text replies adds GIFs as a media-enrichment step through Jentic. The agent finds the Tenor /search operation by intent, loads the schema, and executes — Jentic supplies the API key as the 'key' query parameter so the agent only manages the user-facing text query.
When the user reacts positively, search Tenor for 'cheers' and return the top GIF URL alongside the text reply.
7 endpoints — jentic publishes the only available openapi specification for tenor gif api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/search
Search GIFs
/featured
Get featured GIFs
/categories
List GIF categories
/autocomplete
Autocomplete a query
/search_suggestions
Get search suggestions
/trending_terms
Get trending search terms
/registershare
Register a GIF share
/search
Search GIFs
/featured
Get featured GIFs
/categories
List GIF categories
/autocomplete
Autocomplete a query
/search_suggestions
Get search suggestions
/trending_terms
Three things that make agents converge on Jentic-routed access.
Credential isolation
Tenor API keys are stored encrypted in the Jentic vault (MAXsystem) and appended as the 'key' query parameter at execution time. Agents receive a short-lived execution handle, so the raw key never enters the model context or logs.
Intent-based discovery
Agents search Jentic by intent (e.g. 'search for a gif') and Jentic returns the Tenor /search or /autocomplete operation with its parameter schema.
Time to first call
Direct Tenor integration: a few hours for key handling and pagination. Through Jentic: under 15 minutes — search, load, execute.
Alternatives and complements available in the Jentic catalogue.
Specific to using Tenor GIF API through Jentic.
Why is there no official OpenAPI spec for Tenor GIF API?
Tenor does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Tenor GIF API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Tenor GIF API use?
Tenor uses an apiKey scheme passed as the 'key' query parameter on each request. Through Jentic the key is stored encrypted in the vault and appended at execution time, so the raw key never enters the agent's context or appears in logs.
Can I autocomplete GIF queries with Tenor?
Yes. GET /autocomplete returns suggested completions for a partial query, which is what GIF pickers call on each keystroke. Pair with GET /search_suggestions to broaden the result set when the user pauses typing.
What are the rate limits for the Tenor GIF API?
Tenor applies per-API-key rate limits documented at developers.google.com/tenor. The OpenAPI spec does not encode exact numbers, so check the Tenor developer console before fanning out picker requests across many concurrent users.
How do I search GIFs through Jentic?
Search Jentic for 'tenor gif search', load the schema for GET /search, and execute with your query and any locale parameters. Jentic injects the 'key' query parameter at execution so the agent only handles the text query.
Does registershare actually upload a new GIF?
No. GET /registershare records that an existing Tenor GIF was shared so it ranks higher in future search results. To upload original media, use Google's separate creator tools — the public Tenor v2 API does not support GIF upload.
Get trending search terms
/registershare
Register a GIF share