Giphy

giphy

GIPHY is the first and largest GIF search engine, offering an extensive library of GIFs and Stickers for integration into applications.

Images & Design Lifestyle & Entertainment Web del proveedor

Acciones

Triggers

Autenticación

—

OAuth gestionado

Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (22)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Giphy Analytics RegisterGIPHY_ACTION_REGISTERAcción

Tool 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.

Parámetros de entrada

tsintegerObligatorio
UNIX timestamp in milliseconds when the action occurred.
gif_idstringObligatorio
The unique ID of the GIF or sticker to record analytics for.
random_idstringObligatorio
An ID or proxy for a specific user.
action_typestringObligatorioenum
Type of event to register, one of 'SEEN', 'CLICK', 'SENT'.
SEENCLICKSENT
analytics_response_payloadstringObligatorio
Encoded payload from the provided analytics URL; do not modify.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Emoji VariationsGIPHY_EMOJI_VARIATIONSAcción

Tool to fetch variations for a specific emoji. Use when you have an emoji's GIF ID and want its variations.

Parámetros de entrada

gif_idstringObligatorio
The 'id' value from the GIF Object of the base emoji whose variations you want.

Parámetros de salida

dataobject[]Obligatorio
List of variation Emoji Objects.
metaobjectObligatorio
Response status and metadata.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get GIF by IDGIPHY_GET_GIF_BY_IDAcción

Tool to fetch GIF metadata by its unique ID. Use when you have a valid GIF ID to retrieve metadata.

Parámetros de entrada

gif_idstringObligatorio
The unique ID of the GIF to fetch.
ratingstringenum
Return empty response if the GIF’s rating exceeds this value.
YGPGPG-13R
regionany
ISO 3166-2 subdivision code; include only if proxied and country_code is set.
random_idstring
An ID or proxy for a specific user.
country_codeany
Two-letter ISO 3166-1 alpha-2 country code of the end user; include if requests are proxied.

Parámetros de salida

dataobjectObligatorio
Metadata for the requested GIF.
metaobjectObligatorio
Response status and metadata.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get GIFs by IDsGIPHY_GET_GIFS_BY_IDSAcción

Tool to fetch metadata for multiple GIFs by their IDs. Use when you need information on up to 100 known GIF IDs.

Parámetros de entrada

idsstringObligatorio
Comma-separated list of GIF IDs; maximum 100 IDs.
ratingstringenum
Filter results by rating (g, pg, pg-13, r).
gpgpg-13r
regionstring
ISO 3166-2 subdivision; requires country_code to be set.
random_idstring
An optional unique user or session ID for A/B testing.
country_codestring
Two-letter ISO 3166-1 alpha-2 country code of the end user.

Parámetros de salida

dataobject[]Obligatorio
List of GIF objects for the requested IDs.
metaobjectObligatorio
Response metadata.
errorstring
Error if any occurred during the execution of the action
paginationobjectObligatorio
Pagination information.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Sticker by IDGIPHY_GET_STICKER_BY_IDAcción

Tool to fetch sticker metadata by its unique ID. Use when you have a valid sticker ID to retrieve metadata.

Parámetros de entrada

ratingstringenum
Return empty response if the sticker’s rating exceeds this value.
YGPGPG-13R
regionany
ISO 3166-2 subdivision code; include only if proxied and country_code is set.
random_idstring
An ID or proxy for a specific user.
sticker_idstringObligatorio
The unique ID of the sticker to fetch.
country_codeany
Two-letter ISO 3166-1 alpha-2 country code of the end user; include if requests are proxied.

Parámetros de salida

dataobjectObligatorio
Metadata for the requested sticker.
metaobjectObligatorio
Response status and metadata.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Stickers by IDsGIPHY_GET_STICKERS_BY_IDSAcción

Tool to fetch metadata for multiple stickers by their IDs. Use when you need information on up to 100 known sticker IDs.

Parámetros de entrada

idsstringObligatorio
Comma-separated list of sticker IDs; maximum 100 IDs.
ratingstringenum
Filter results by rating (g, pg, pg-13, r).
gpgpg-13r
regionstring
ISO 3166-2 subdivision; requires country_code to be set.
random_idstring
An optional unique user or session ID for A/B testing.
country_codestring
Two-letter ISO 3166-1 alpha-2 country code of the end user.

Parámetros de salida

dataobject[]Obligatorio
List of sticker objects for the requested IDs.
metaobjectObligatorio
Response metadata.
errorstring
Error if any occurred during the execution of the action
paginationobjectObligatorio
Pagination information.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

GIPHY CategoriesGIPHY_GIPHY_CATEGORIESAcción

Tool to fetch a list of GIF categories on GIPHY. Use when you need to browse available categories before selecting one.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobject[]Obligatorio
List of GIF category objects.
metaobjectObligatorio
Response metadata.
errorstring
Error if any occurred during the execution of the action
paginationobjectObligatorio
Pagination information.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

GIPHY: Get Category by IDGIPHY_GIPHY_CATEGORY_BY_IDAcción

Tool to fetch metadata for a GIF category by its unique ID. Use when you need details for a specific category identifier.

Parámetros de entrada

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

Parámetros de salida

dataobjectObligatorio
Metadata for the requested GIF category.
metaobjectObligatorio
Response status and metadata.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

GIPHY: Category GIFsGIPHY_GIPHY_CATEGORY_GIFSAcción

Tool to fetch GIFs associated with a specific GIF category. Use after retrieving category_id from the categories endpoint to get curated GIFs.

Parámetros de entrada

limitinteger
Max number of GIFs to return; default 25; maximum 499.
bundlestring
Restrict renditions to the specified bundle (e.g., 'messaging_non_clips').
offsetinteger
Starting position of results; default 0; maximum 4999.
ratingstringenum
Filter results by content rating: g, pg, pg-13, or r.
gpgpg-13r
regionstring
ISO 3166-2 subdivision code; specify if proxied and country_code is proxied.
random_idstring
An ID or proxy for a specific user session.
category_idstringObligatorio
The unique identifier (slug or ID) of the GIF category to fetch.
country_codestring
Two-letter ISO 3166-1 alpha-2 country code of the end user.
remove_low_contrastboolean
Exclude low-contrast items from results.

Parámetros de salida

dataobject[]Obligatorio
Array of GIF objects in the specified category
metaobjectObligatorio
Metadata about the API response
errorstring
Error if any occurred during the execution of the action
paginationobjectObligatorio
Pagination details for the result set
successfulbooleanObligatorio
Whether or not the action execution was successful or not

GIPHY EmojiGIPHY_GIPHY_EMOJIAcción

Tool to fetch GIPHY emoji GIF objects. Use when you need a paginated list of GIPHY emojis.

Parámetros de entrada

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

Parámetros de salida

dataobject[]Obligatorio
List of emoji GIF objects with variations and media renditions
metaobjectObligatorio
Metadata about the API response
errorstring
Error if any occurred during the execution of the action
paginationobjectObligatorio
Pagination details for this response
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Related TagsGIPHY_GIPHY_TAG_RELATEDAcción

Tool to fetch tags related to a specified tag. Use when you want to find semantically related tags for improved search suggestion.

Parámetros de entrada

termstringObligatorio
Tag term to find related tags.

Parámetros de salida

dataobject[]Obligatorio
Array of related tag terms.
metaobjectObligatorio
Response status and metadata.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

GIPHY: Tag SearchGIPHY_GIPHY_TAG_SEARCHAcción

Tool to search GIPHY's tag library for autocomplete suggestions. Use when you need to generate tag suggestions for a user query.

Parámetros de entrada

qstringObligatorio
Tag term to autocomplete; search query for tag suggestions.
limitinteger
Maximum number of tag suggestions to return; default is 5.
offsetinteger
Starting position of results; default is 0.

Parámetros de salida

dataobject[]Obligatorio
Array of tag suggestion objects.
metaobjectObligatorio
Metadata about the API response.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

GIPHY Trending TagsGIPHY_GIPHY_TAG_TRENDINGAcción

Tool to fetch the most popular search terms (tags) on GIPHY. Use when you need trending tags for content discovery.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

datastring[]Obligatorio
List of trending search terms
metaobjectObligatorio
Metadata about the API response
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

GIPHY Translate StickerGIPHY_GIPHY_TRANSLATE_STICKERAcción

Tool 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.

Parámetros de entrada

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

Parámetros de salida

dataobjectObligatorio
A single sticker object and its metadata as returned by GIPHY.
metaobjectObligatorio
Response metadata including status and response ID.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Trending StickersGIPHY_GIPHY_TRENDING_STICKERSAcción

Tool to fetch trending stickers. Use when you need the most relevant and engaging sticker GIFs currently trending.

Parámetros de entrada

limitinteger
Maximum number of sticker GIFs to return. Defaults to 25.
bundlestring
Return only renditions for the named bundle.
offsetinteger
Starting position of results (zero-indexed). Defaults to 0. Maximum 499.
ratingstringenum
Filter results by content rating (g, pg, pg-13, r).
gpgpg-13r
regionstring
ISO 3166-2 subdivision code; requires country_code to be set.
random_idstring
An optional unique user or session ID for A/B testing.
country_codestring
Two-letter ISO 3166-1 alpha-2 country code of the end user, uppercase.
remove_low_contrastboolean
Exclude low-contrast stickers from results.

Parámetros de salida

dataobject[]Obligatorio
List of trending sticker GIF objects.
metaobjectObligatorio
Response metadata.
errorstring
Error if any occurred during the execution of the action
paginationobjectObligatorio
Pagination information.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Giphy Random GIFGIPHY_RANDOM_GIFAcción

Tool 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.'

Parámetros de entrada

tagstring
Filter results by a tag; supports @username tagging
ratingstringenum
Filter by content rating; one of 'y','g','pg','pg-13','r'
ygpgpg-13r
random_idstring
Unique ID/proxy for a specific user

Parámetros de salida

dataobjectObligatorio
Random GIF object returned by Giphy
metaobjectObligatorio
Response metadata from Giphy API
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Giphy Random StickerGIPHY_RANDOM_STICKERAcción

Tool to fetch a single random sticker. Use when you need a random sticker, optionally filtered by tag or rating.

Parámetros de entrada

tagstring
Filter results by a tag; supports @username tagging
ratingstringenum
Filter by content rating; one of 'g', 'pg', 'pg-13', 'r'
gpgpg-13r
regionstring
ISO 3166-2 subdivision code; requires country_code to be set
random_idstring
An ID/proxy for a specific user session
country_codestring
Two-letter ISO 3166-1 alpha-2 code for end-user country

Parámetros de salida

dataobjectObligatorio
Full sticker object returned by Giphy
metaobjectObligatorio
Response metadata
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

GIPHY: Search GIFsGIPHY_SEARCH_GIFSAcción

Tool to search GIPHY's GIF library. Use when you need to find GIFs by keyword or phrase.

Parámetros de entrada

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

Parámetros de salida

dataobject[]Obligatorio
Array of GIF objects matching the search query
metaobjectObligatorio
Metadata about the API response
errorstring
Error if any occurred during the execution of the action
paginationobjectObligatorio
Pagination information for the result set
successfulbooleanObligatorio
Whether or not the action execution was successful or not

GIPHY: Search StickersGIPHY_SEARCH_STICKERSAcción

Tool to search GIPHY's sticker library. Use when you need to find stickers by keyword or phrase.

Parámetros de entrada

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

Parámetros de salida

dataobject[]Obligatorio
Array of sticker GIF objects matching the search query
metaobjectObligatorio
Metadata about the API response
errorstring
Error if any occurred during the execution of the action
paginationobjectObligatorio
Pagination information for the result set
successfulbooleanObligatorio
Whether or not the action execution was successful or not

GIPHY: Random TagGIPHY_TAG_RANDOMAcción

Tool to fetch a single random tag from Giphy. Use when you need a random search term tag, optionally filtered by a query term.

Parámetros de entrada

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

Parámetros de salida

dataobjectObligatorio
Random tag object returned by GIPHY
metaobjectObligatorio
Response metadata from GIPHY API
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

GIPHY Trending GIFsGIPHY_TRENDING_GIFSAcción

Tool to fetch trending GIFs from GIPHY. Use when you need the most relevant and engaging GIFs currently trending.

Parámetros de entrada

limitinteger
Maximum number of GIFs to return (1-499).
bundlestring
Restrict renditions to the specified bundle (e.g., 'messaging_non_clips').
offsetinteger
Starting position of results (0-499).
ratingstringenum
Filter results by GIF rating. One of 'g', 'pg', 'pg-13', 'r'.
gpgpg-13r
regionstring
End user's region code (ISO 3166-2).
random_idstring
An ID/proxy string to identify the user session.
country_codestring
End user's country code (ISO 3166-1 alpha-2).
remove_low_contrastboolean
Whether to exclude low-contrast GIFs.

Parámetros de salida

dataobject[]Obligatorio
A list of GIF objects as returned by the GIPHY API.
metaobjectObligatorio
Meta information about the API response.
errorstring
Error if any occurred during the execution of the action
paginationobjectObligatorio
Pagination information for the returned GIFs.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Giphy Upload GIFGIPHY_UPLOAD_GIFAcción

Tool 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.

Parámetros de entrada

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

Parámetros de salida

dataobjectObligatorio
Uploaded GIF data
metaobjectObligatorio
Response metadata
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not