GIPHY is the first and largest GIF search engine, offering an extensive library of GIFs and Stickers for integration into applications.
GIPHY is the first and largest GIF search engine, offering an extensive library of GIFs and Stickers for integration into applications. On Nagent, Giphy is exposed as a fully-configurable images & design integration that any agent can call — 23 actions, and API key authentication. No code is required to wire Giphy into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Giphy to automate the kinds of tasks images & design teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Giphy into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Giphy, with input parameters and output schema. Drop these into any step of an agent built in Helix.
GIPHY_ACTION_REGISTERTool to register user interactions (view, click, send) with a GIF for analytics. Use when you have the analytics payload, timestamp, and user ID to record the event.
Input parameters
UNIX timestamp in milliseconds when the action occurred.
The unique ID of the GIF or sticker to record analytics for.
An ID or proxy for a specific user.
Type of event to register, one of 'SEEN', 'CLICK', 'SENT'.
Encoded payload from the provided analytics URL; do not modify.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GIPHY_CATEGORIESTool to fetch a list of GIF categories on GIPHY. Use when you need to browse available categories before selecting one.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GIPHY_CATEGORY_BY_IDTool to fetch metadata for a GIF category by its unique ID. Use when you need details for a specific category identifier.
Input parameters
Unique identifier (encoded name) of the GIF category to fetch.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GIPHY_CATEGORY_GIFSTool to fetch GIFs associated with a specific GIF category. Use after retrieving category_id from the categories endpoint to get curated GIFs.
Input parameters
Max number of GIFs to return; default 25; maximum 499.
Restrict renditions to the specified bundle (e.g., 'messaging_non_clips').
Starting position of results; default 0; maximum 4999.
Filter results by content rating: g, pg, pg-13, or r.
ISO 3166-2 subdivision code; specify if proxied and country_code is proxied.
An ID or proxy for a specific user session.
The unique identifier (slug or ID) of the GIF category to fetch.
Two-letter ISO 3166-1 alpha-2 country code of the end user.
Exclude low-contrast items from results.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GIPHY_EMOJITool to fetch GIPHY emoji GIF objects. Use when you need a paginated list of GIPHY emojis.
Input parameters
Maximum number of emoji objects to return (default is 25).
Zero-based offset for pagination (default is 0).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GIPHY_EMOJI_VARIATIONSTool to fetch variations for a specific emoji. Use when you have an emoji's GIF ID and want its variations.
Input parameters
The 'id' value from the GIF Object of the base emoji whose variations you want.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GIPHY_GET_CONTENT_BY_IDTool to fetch content metadata by its unique ID. Generalizes the Get GIF by ID endpoint for all content types (GIFs, Stickers, and Clips).
Input parameters
Return empty response if the content's rating exceeds this value.
ISO 3166-2 subdivision code; include only if proxied and country_code is set.
An ID or proxy for a specific user.
The unique ID of the content to fetch (GIF, Sticker, or Clip).
Two-letter ISO 3166-1 alpha-2 country code of the end user; include if requests are proxied.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GIPHY_GET_CONTENT_BY_IDSTool to fetch metadata for multiple pieces of content (GIFs, Stickers, or Clips) by their IDs. Use when you need information on up to 100 known content IDs across any GIPHY content type.
Input parameters
Comma-separated list of content IDs (GIFs, Stickers, or Clips); maximum 100 IDs.
Filter results by rating (g, pg, pg-13, r).
ISO 3166-2 subdivision; requires country_code to be set.
An optional unique user or session ID for A/B testing.
Two-letter ISO 3166-1 alpha-2 country code of the end user.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GIPHY_GET_RANDOM_IDTool to generate a unique random ID from Giphy. Use when you need to create a unique identifier for a new user that can be used with other Giphy endpoints to personalize API responses.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GIPHY_RANDOM_GIFTool to fetch a random GIF from Giphy. Use when you need a single random GIF, optionally filtered by tag or rating. Example: 'Get a random cat GIF rated G.'
Input parameters
Filter results by a tag; supports @username tagging
Filter by content rating; one of 'y','g','pg','pg-13','r'
Unique ID/proxy for a specific user
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GIPHY_RANDOM_STICKERTool to fetch a single random sticker. Use when you need a random sticker, optionally filtered by tag or rating.
Input parameters
Filter results by a tag; supports @username tagging
Filter by content rating; one of 'g', 'pg', 'pg-13', 'r'
ISO 3166-2 subdivision code; requires country_code to be set
An ID/proxy for a specific user session
Two-letter ISO 3166-1 alpha-2 code for end-user country
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GIPHY_SEARCH_CHANNELSTool to search for GIPHY channels by query term. Use when you need to find channels matching a specific topic or keyword.
Input parameters
Search term for GIPHY channels
Maximum number of channels to return (1-50, default: 25)
Starting position of results (default: 0)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GIPHY_SEARCH_GIFSTool to search GIPHY's GIF library. Use when you need to find GIFs by keyword or phrase.
Input parameters
Search query term/phrase; @<username> searches a specific user’s GIFs. If contains 'sticker' returns stickers.
2-letter ISO 639-1 code for regional content
Max number of objects to return; default 25; beta keys max limit is 50
Returns only renditions that correspond to the named bundle
Comma-separated list of fields to return (Fields on Demand)
Result starting position; default 0; maximum 4999
Filters by rating; acceptable values: g, pg, pg-13, r
ISO 3166-2 country subdivision; specify if proxied and country_code is proxied
ID/proxy for a specific user
Two-letter ISO 3166-1 alpha-2 country of the end user
Exclude low-contrast items from results
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GIPHY_SEARCH_STICKERSTool to search GIPHY's sticker library. Use when you need to find stickers by keyword or phrase.
Input parameters
Search query term/phrase for stickers; returns matching sticker items.
2-letter ISO 639-1 code for regional content
Max number of items to return; default 25; beta keys max limit is 50
Returns only renditions that correspond to the named bundle
Result starting position; default 0; maximum 4999
Filters by rating; acceptable values: g, pg, pg-13, r
ISO 3166-2 country subdivision; specify if proxied and country_code is proxied
An ID/proxy for a specific user
Two-letter ISO 3166-1 alpha-2 country of the end user
Exclude low-contrast items from results
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GIPHY_TAG_RANDOMTool to fetch a single random tag from Giphy. Use when you need a random search term tag, optionally filtered by a query term.
Input parameters
Filter results by a search term for the tag
Unique ID/proxy for a specific user session
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GIPHY_TAG_RELATEDTool to fetch tags related to a specified tag. Use when you want to find semantically related tags for improved search suggestion.
Input parameters
Tag term to find related tags.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GIPHY_TAG_SEARCHTool to search GIPHY's tag library for autocomplete suggestions. Use when you need to generate tag suggestions for a user query.
Input parameters
Tag term to autocomplete; search query for tag suggestions.
Maximum number of tag suggestions to return; default is 5.
Starting position of results; default is 0.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GIPHY_TAG_TRENDINGTool to fetch the most popular search terms (tags) on GIPHY. Use when you need trending tags for content discovery.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GIPHY_TRANSLATE_GIFTool to translate a term or phrase into a single GIF using GIPHY's special algorithm. Use when you need to convert words into the perfect GIF representation.
Input parameters
Search term to translate into a GIF.
Filter results by rating; acceptable values: g, pg, pg-13, r.
ISO 3166-2 subdivision code; include only if proxied and country_code is set.
An ID or proxy for a specific user.
Two-letter ISO 3166-1 alpha-2 end-user country code; include if requests are proxied.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GIPHY_TRANSLATE_STICKERTool to translate a term or phrase into a single sticker using GIPHY’s translation algorithm. Use after confirming the exact phrase to visualize as a sticker.
Input parameters
Term or phrase to translate into a sticker. Supports @username and #hashtag hints.
Filter results by rating; acceptable values: g, pg, pg-13, r.
ISO 3166-2 subdivision code; include only if proxied and country_code is set.
An ID or proxy for a specific user.
Two-letter ISO 3166-1 alpha-2 end-user country code; include if requests are proxied.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GIPHY_TRENDING_GIFSTool to fetch trending GIFs from GIPHY. Use when you need the most relevant and engaging GIFs currently trending.
Input parameters
Maximum number of GIFs to return (1-499).
Restrict renditions to the specified bundle (e.g., 'messaging_non_clips').
Starting position of results (0-499).
Filter results by GIF rating. One of 'g', 'pg', 'pg-13', 'r'.
End user's region code (ISO 3166-2).
An ID/proxy string to identify the user session.
End user's country code (ISO 3166-1 alpha-2).
Whether to exclude low-contrast GIFs.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GIPHY_TRENDING_STICKERSTool to fetch trending stickers. Use when you need the most relevant and engaging sticker GIFs currently trending.
Input parameters
Maximum number of sticker GIFs to return. Defaults to 25.
Return only renditions for the named bundle.
Starting position of results (zero-indexed). Defaults to 0. Maximum 499.
Filter results by content rating (g, pg, pg-13, r).
ISO 3166-2 subdivision code; requires country_code to be set.
An optional unique user or session ID for A/B testing.
Two-letter ISO 3166-1 alpha-2 country code of the end user, uppercase.
Exclude low-contrast stickers from results.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GIPHY_UPLOAD_GIFTool to upload a GIF or video file to GIPHY. Use when you need to create a new GIPHY entry from a local file or public URL. Requires developer API key and supports optional metadata.
Input parameters
Binary data of the animated GIF or video file. Required if source_image_url is not provided.
Comma-delimited list of tags to apply to the upload.
ISO 3166-2 country subdivision code; requires country_code.
Two-letter ISO 3166-1 alpha-2 country code of the end user.
URL of the source page for the asset.
Public URL of the image or video to upload. Required if file is not provided.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 35 agents privately built on Nagent that already use Giphy.
Build on Nagent
Connect Giphy to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Giphy, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, Giphy is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Giphy is connected, you configure its 23 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Giphy steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Giphy event fires, the agent kicks off automatically.
Every Giphy action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Giphy ships with 23 pre-built images & design actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Giphy together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Giphy-based workflows tailored to your business.