Skip to main content
Giphy logo
  • Category: images & design
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 23
  • Triggers: 0
  • Slug: GIPHY
  • Version: 20261101_00

Tools

Slug: GIPHY_ACTION_REGISTERSend a GIF or sticker interaction analytics pingback for a view, click, or send event using the supplied analytics payload, timestamp, and user ID. These events help GIPHY improve search results.

Input Parameters

integer
required
UNIX timestamp in milliseconds when the action occurred.
string
required
The unique ID of the GIF or sticker to record analytics for.
string
required
An ID or proxy for a specific user.
string ("SEEN" | "CLICK" | "SENT")
required
Type of event to register, one of ‘SEEN’, ‘CLICK’, ‘SENT’.
string
required
Encoded payload from the provided analytics URL; do not modify.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GIPHY_CATEGORIESTool to fetch a list of GIF categories on GIPHY. Use when you need to browse available categories before selecting one.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GIPHY_CATEGORY_BY_IDFetch subcategories for a GIF category identified by its encoded name, including featured GIF details and pagination.

Input Parameters

string
required
Unique identifier (encoded name) of the GIF category to fetch.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

integer
Max number of GIFs to return; default 25; maximum 499.
string
Restrict renditions to the specified bundle (e.g., ‘messaging_non_clips’).
integer
Starting position of results; default 0; maximum 4999.
string ("g" | "pg" | "pg-13" | "r")
Filter results by content rating: g, pg, pg-13, or r.
string
ISO 3166-2 subdivision code; specify if proxied and country_code is proxied.
string
An ID or proxy for a specific user session.
string
required
The unique identifier (slug or ID) of the GIF category to fetch.
string
Two-letter ISO 3166-1 alpha-2 country code of the end user.
boolean
Exclude low-contrast items from results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GIPHY_EMOJITool to fetch GIPHY emoji GIF objects. Use when you need a paginated list of GIPHY emojis.

Input Parameters

integer
Maximum number of emoji objects to return (default is 25).
integer
Zero-based offset for pagination (default is 0).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
The ‘id’ value from the GIF Object of the base emoji whose variations you want.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string ("Y" | "G" | "PG" | "PG-13" | "R")
Return empty response if the content’s rating exceeds this value.
string
ISO 3166-2 subdivision code; include only if proxied and country_code is set.
string
An ID or proxy for a specific user.
string
required
The unique ID of the content to fetch (GIF, Sticker, or Clip).
string
Two-letter ISO 3166-1 alpha-2 country code of the end user; include if requests are proxied.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
Comma-separated list of content IDs (GIFs, Stickers, or Clips); maximum 100 IDs.
string ("g" | "pg" | "pg-13" | "r")
Filter results by rating (g, pg, pg-13, r).
string
ISO 3166-2 subdivision; requires country_code to be set.
string
An optional unique user or session ID for A/B testing.
string
Two-letter ISO 3166-1 alpha-2 country code of the end user.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Filter results by a tag; supports @username tagging
string ("y" | "g" | "pg" | "pg-13" | "r")
Filter by content rating; one of ‘y’,‘g’,‘pg’,‘pg-13’,‘r’
string
Unique ID/proxy for a specific user

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GIPHY_RANDOM_STICKERTool to fetch a single random sticker. Use when you need a random sticker, optionally filtered by tag or rating.

Input Parameters

string
Filter results by a tag; supports @username tagging
string ("g" | "pg" | "pg-13" | "r")
Filter by content rating; one of ‘g’, ‘pg’, ‘pg-13’, ‘r’
string
ISO 3166-2 subdivision code; requires country_code to be set
string
An ID/proxy for a specific user session
string
Two-letter ISO 3166-1 alpha-2 code for end-user country

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
Search term for GIPHY channels
integer
Maximum number of channels to return (1-50, default: 25)
integer
Starting position of results (default: 0)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GIPHY_SEARCH_GIFSTool to search GIPHY’s GIF library. Use when you need to find GIFs by keyword or phrase.

Input Parameters

string
required
Search query term/phrase; @<username> searches a specific user’s GIFs. If contains ‘sticker’ returns stickers.
string
2-letter ISO 639-1 code for regional content
integer
Max number of objects to return; default 25; beta keys max limit is 50
string
Returns only renditions that correspond to the named bundle
string
Comma-separated list of fields to return (Fields on Demand)
integer
Result starting position; default 0; maximum 4999
string ("g" | "pg" | "pg-13" | "r")
Filters by rating; acceptable values: g, pg, pg-13, r
string
ISO 3166-2 country subdivision; specify if proxied and country_code is proxied
string
ID/proxy for a specific user
string
Two-letter ISO 3166-1 alpha-2 country of the end user
boolean
Exclude low-contrast items from results

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GIPHY_SEARCH_STICKERSTool to search GIPHY’s sticker library. Use when you need to find stickers by keyword or phrase.

Input Parameters

string
required
Search query term/phrase for stickers; returns matching sticker items.
string
2-letter ISO 639-1 code for regional content
integer
Max number of items to return; default 25; beta keys max limit is 50
string
Returns only renditions that correspond to the named bundle
integer
Result starting position; default 0; maximum 4999
string ("g" | "pg" | "pg-13" | "r")
Filters by rating; acceptable values: g, pg, pg-13, r
string
ISO 3166-2 country subdivision; specify if proxied and country_code is proxied
string
An ID/proxy for a specific user
string
Two-letter ISO 3166-1 alpha-2 country of the end user
boolean
Exclude low-contrast items from results

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GIPHY_TAG_RANDOMSelect a random search term from GIPHY’s trending searches, or from terms related to a supplied tag.

Input Parameters

string
Filter results by a search term for the tag
string
Unique ID/proxy for a specific user session

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
Tag term to autocomplete; search query for tag suggestions.
integer
Maximum number of tag suggestions to return; default is 5.
integer
Starting position of results; default is 0.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
Search term to translate into a GIF.
string ("g" | "pg" | "pg-13" | "r")
Filter results by rating; acceptable values: g, pg, pg-13, r.
string
ISO 3166-2 subdivision code; include only if proxied and country_code is set.
string
An ID or proxy for a specific user.
string
Two-letter ISO 3166-1 alpha-2 end-user country code; include if requests are proxied.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GIPHY_TRANSLATE_STICKERTranslate a term or phrase into a single sticker using GIPHY’s translation algorithm. Optionally filter the result by content rating.

Input Parameters

string
required
Term or phrase to translate into a sticker. Supports @username and #hashtag hints.
string ("g" | "pg" | "pg-13" | "r")
Filter results by rating; acceptable values: g, pg, pg-13, r.
string
ISO 3166-2 subdivision code; include only if proxied and country_code is set.
string
An ID or proxy for a specific user.
string
Two-letter ISO 3166-1 alpha-2 end-user country code; include if requests are proxied.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Binary data of the animated GIF or video file. Required if source_image_url is not provided.
string
Comma-delimited list of tags to apply to the upload.
string
ISO 3166-2 country subdivision code; requires country_code.
string
Two-letter ISO 3166-1 alpha-2 country code of the end user.
string
URL of the source page for the asset.
string
Public URL of the image or video to upload. Required if file is not provided.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not