# Giphy

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

- **Category:** images & design
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 27
- **Triggers:** 0
- **Slug:** `GIPHY`
- **Version:** 20260225_00

## Tools

### Giphy Analytics Register

**Slug:** `GIPHY_ACTION_REGISTER`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ts` | integer | Yes | UNIX timestamp in milliseconds when the action occurred. |
| `gif_id` | string | Yes | The unique ID of the GIF or sticker to record analytics for. |
| `random_id` | string | Yes | An ID or proxy for a specific user. |
| `action_type` | string ("SEEN" | "CLICK" | "SENT") | Yes | Type of event to register, one of 'SEEN', 'CLICK', 'SENT'. |
| `analytics_response_payload` | string | Yes | Encoded payload from the provided analytics URL; do not modify. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### GIPHY Categories

**Slug:** `GIPHY_CATEGORIES`

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### GIPHY: Get Category by ID

**Slug:** `GIPHY_CATEGORY_BY_ID`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `category_id` | string | Yes | Unique identifier (encoded name) of the GIF category to fetch. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### GIPHY: Category GIFs

**Slug:** `GIPHY_CATEGORY_GIFS`

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

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### GIPHY Emoji

**Slug:** `GIPHY_EMOJI`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of emoji objects to return (default is 25). |
| `offset` | integer | No | Zero-based offset for pagination (default is 0). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Emoji Variations

**Slug:** `GIPHY_EMOJI_VARIATIONS`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `gif_id` | string | Yes | The 'id' value from the GIF Object of the base emoji whose variations you want. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Content by ID

**Slug:** `GIPHY_GET_CONTENT_BY_ID`

Tool 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

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Content by IDs

**Slug:** `GIPHY_GET_CONTENT_BY_IDS`

Tool 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

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Giphy Get Random ID

**Slug:** `GIPHY_GET_RANDOM_ID`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Giphy Random GIF

**Slug:** `GIPHY_RANDOM_GIF`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tag` | string | No | Filter results by a tag; supports @username tagging |
| `rating` | string ("y" | "g" | "pg" | "pg-13" | "r") | No | Filter by content rating; one of 'y','g','pg','pg-13','r' |
| `random_id` | string | No | Unique ID/proxy for a specific user |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Giphy Random Sticker

**Slug:** `GIPHY_RANDOM_STICKER`

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

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### GIPHY: Search Channels

**Slug:** `GIPHY_SEARCH_CHANNELS`

Tool to search for GIPHY channels by query term. Use when you need to find channels matching a specific topic or keyword.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `q` | string | Yes | Search term for GIPHY channels |
| `limit` | integer | No | Maximum number of channels to return (1-50, default: 25) |
| `offset` | integer | No | Starting position of results (default: 0) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### GIPHY: Search GIFs

**Slug:** `GIPHY_SEARCH_GIFS`

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

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### GIPHY: Search Stickers

**Slug:** `GIPHY_SEARCH_STICKERS`

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

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### GIPHY: Random Tag

**Slug:** `GIPHY_TAG_RANDOM`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tag` | string | No | Filter results by a search term for the tag |
| `random_id` | string | No | Unique ID/proxy for a specific user session |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Related Tags

**Slug:** `GIPHY_TAG_RELATED`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `term` | string | Yes | Tag term to find related tags. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### GIPHY: Tag Search

**Slug:** `GIPHY_TAG_SEARCH`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `q` | string | Yes | Tag term to autocomplete; search query for tag suggestions. |
| `limit` | integer | No | Maximum number of tag suggestions to return; default is 5. |
| `offset` | integer | No | Starting position of results; default is 0. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### GIPHY Trending Tags

**Slug:** `GIPHY_TAG_TRENDING`

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### GIPHY Translate GIF

**Slug:** `GIPHY_TRANSLATE_GIF`

Tool 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

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### GIPHY Translate Sticker

**Slug:** `GIPHY_TRANSLATE_STICKER`

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.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### GIPHY Trending GIFs

**Slug:** `GIPHY_TRENDING_GIFS`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of GIFs to return (1-499). |
| `bundle` | string | No | Restrict renditions to the specified bundle (e.g., 'messaging_non_clips'). |
| `offset` | integer | No | Starting position of results (0-499). |
| `rating` | string ("g" | "pg" | "pg-13" | "r") | No | Filter results by GIF rating. One of 'g', 'pg', 'pg-13', 'r'. |
| `region` | string | No | End user's region code (ISO 3166-2). |
| `random_id` | string | No | An ID/proxy string to identify the user session. |
| `country_code` | string | No | End user's country code (ISO 3166-1 alpha-2). |
| `remove_low_contrast` | boolean | No | Whether to exclude low-contrast GIFs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Trending Stickers

**Slug:** `GIPHY_TRENDING_STICKERS`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of sticker GIFs to return. Defaults to 25. |
| `bundle` | string | No | Return only renditions for the named bundle. |
| `offset` | integer | No | Starting position of results (zero-indexed). Defaults to 0. Maximum 499. |
| `rating` | string ("g" | "pg" | "pg-13" | "r") | No | Filter results by content rating (g, pg, pg-13, r). |
| `region` | string | No | ISO 3166-2 subdivision code; requires country_code to be set. |
| `random_id` | string | No | An optional unique user or session ID for A/B testing. |
| `country_code` | string | No | Two-letter ISO 3166-1 alpha-2 country code of the end user, uppercase. |
| `remove_low_contrast` | boolean | No | Exclude low-contrast stickers from results. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Giphy Upload GIF

**Slug:** `GIPHY_UPLOAD_GIF`

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.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |
