> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to GIPHY

The GIPHY connector lets your AI agent act in each user's GIPHY account. Each user connects their own GIPHY API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 14 tools.

**Authentication:** API Key
**Categories:** Media
**Tools:** 14: 13 read, 1 write, 0 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=GIPHY)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the GIPHY connection

   In **AgentKit > Connections**, create a GIPHY connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'giphy'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize GIPHY:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'giphy_categories_list',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "giphy"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize GIPHY:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="giphy_categories_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their GIPHY credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'giphy_categories_list',
  toolInput: {},
  connector: 'giphy',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="giphy_categories_list",
    tool_input={},
    connection_name="giphy",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `giphy_categories_list`

List Categories · Read-only

List GIPHY's GIF categories with their subcategories.
Returns data[] of categories with name, name_encoded, a representative GIF and subcategories.
Use a category name as a search term with giphy_search.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `customer_id` (`string`, optional): Stable, non-personal ID of the end user in your app, used by GIPHY to personalize results; use the random_id from giphy_random_id_create if you have none. Example: e826c9fc5c929e0d6c6d423841a282aa.

Example input: `{}`

### `giphy_channels_search`

Search Channels · Read-only

Search GIPHY channels (brands, artists and creators) by name.
Returns data[] of channel objects with id, display_name, slug, url and user, and pagination.
Use @username in giphy_search to search one channel's GIFs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): Term to search channels for. Example: nba.
- `customer_id` (`string`, optional): Stable, non-personal ID of the end user in your app, used by GIPHY to personalize results; use the random_id from giphy_random_id_create if you have none. Example: e826c9fc5c929e0d6c6d423841a282aa.
- `limit` (`integer`, optional): Maximum number of results (default 25, max 50). Example: 10.
- `offset` (`integer`, optional): Number of results to skip, for paging (default 0). Example: 10.

Example input: `{"q":"<q>"}`

### `giphy_emoji_list`

List Emoji · Read-only

List GIPHY's animated emoji.
Returns data[] of emoji GIF objects with variation_count (number of skin-tone or style variations) and pagination.
Use giphy_emoji_variations_list for an emoji's variations.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `customer_id` (`string`, optional): Stable, non-personal ID of the end user in your app, used by GIPHY to personalize results; use the random_id from giphy_random_id_create if you have none. Example: e826c9fc5c929e0d6c6d423841a282aa.
- `limit` (`integer`, optional): Maximum number of results (default 25, max 50). Example: 10.
- `offset` (`integer`, optional): Number of results to skip, for paging (default 0). Example: 10.

Example input: `{}`

### `giphy_emoji_variations_list`

List Emoji Variations · Read-only

List the variations (skin tones or styles) of a GIPHY emoji.
Returns data[] of emoji GIF objects.
Use when an emoji from giphy_emoji_list has variation_count above 0.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `gif_id` (`string`, required): GIPHY ID of the emoji. Example: dalJ0CpF7hwmN1nZXe.
- `customer_id` (`string`, optional): Stable, non-personal ID of the end user in your app, used by GIPHY to personalize results; use the random_id from giphy_random_id_create if you have none. Example: e826c9fc5c929e0d6c6d423841a282aa.

Example input: `{"gif_id":"<gif_id>"}`

### `giphy_gif_get`

Get GIF · Read-only

Get one GIF's metadata by its GIPHY ID.
Returns data, the GIF object with title, url, images in each rendition, rating, user and import date.
Use giphy_gifs_get for several IDs at once.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `gif_id` (`string`, required): GIPHY ID of the GIF. Example: xT4uQulxzV39haRFjG.
- `country_code` (`string`, optional): End user's country, two-letter ISO 3166-1 code. Example: US.
- `customer_id` (`string`, optional): Stable, non-personal ID of the end user in your app, used by GIPHY to personalize results; use the random_id from giphy_random_id_create if you have none. Example: e826c9fc5c929e0d6c6d423841a282aa.
- `rating` (`string`, optional): If the GIF's rating is higher than this (g, pg, pg-13, r), GIPHY returns an empty result with an error code. One of: `g`, `pg`, `pg-13`, `r`.
- `region` (`string`, optional): End user's country subdivision, ISO 3166-2 code; use with country_code. Example: VA.

Example input: `{"gif_id":"<gif_id>"}`

### `giphy_gifs_get`

Get GIFs By IDs · Read-only

Get the metadata of up to 100 GIFs by their GIPHY IDs.
Returns data[] of GIF objects and pagination.
Use giphy_gif_get for a single GIF.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ids` (`string`, required): GIPHY GIF IDs, comma-separated, up to 100. Example: xT4uQulxzV39haRFjG,3og0IPxMM0erATueVW.
- `country_code` (`string`, optional): End user's country, two-letter ISO 3166-1 code. Example: US.
- `customer_id` (`string`, optional): Stable, non-personal ID of the end user in your app, used by GIPHY to personalize results; use the random_id from giphy_random_id_create if you have none. Example: e826c9fc5c929e0d6c6d423841a282aa.
- `rating` (`string`, optional): Highest content rating to return: g, pg, pg-13 or r. Leave empty for all ratings. One of: `g`, `pg`, `pg-13`, `r`.
- `region` (`string`, optional): End user's country subdivision, ISO 3166-2 code; use with country_code. Example: VA.

Example input: `{"ids":"<ids>"}`

### `giphy_random`

Get Random GIF · Read-only

Get one random GIF or sticker, optionally related to a tag.
Returns data, one GIF object with id, title, url and images.
Use giphy_translate for the best match to a phrase.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `country_code` (`string`, optional): End user's country, two-letter ISO 3166-1 code. Example: US.
- `customer_id` (`string`, optional): Stable, non-personal ID of the end user in your app, used by GIPHY to personalize results; use the random_id from giphy_random_id_create if you have none. Example: e826c9fc5c929e0d6c6d423841a282aa.
- `kind` (`string`, optional): Content type: gifs (default) or stickers (transparent GIFs). One of: `gifs`, `stickers`. Default: `gifs`.
- `rating` (`string`, optional): Highest content rating to return: g, pg, pg-13 or r. Leave empty for all ratings. One of: `g`, `pg`, `pg-13`, `r`.
- `region` (`string`, optional): End user's country subdivision, ISO 3166-2 code; use with country_code. Example: VA.
- `tag` (`string`, optional): Only a GIF with this tag. Leave empty for any GIF. Example: burrito.

Example input: `{}`

### `giphy_related_tags_list`

List Related Tags · Read-only

Get search suggestions: tag terms related to a given term.
Returns data[] of terms (name).
Use giphy_tags_autocomplete to complete a partial term.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `term` (`string`, required): Tag term to find related terms for. Example: haha.
- `customer_id` (`string`, optional): Stable, non-personal ID of the end user in your app, used by GIPHY to personalize results; use the random_id from giphy_random_id_create if you have none. Example: e826c9fc5c929e0d6c6d423841a282aa.

Example input: `{"term":"<term>"}`

### `giphy_search`

Search GIFs · Read-only

Search GIPHY's library of GIFs or stickers for a word or phrase; start q with @username to search one channel.
Returns data[] of GIF objects (id, title, url, images in several renditions, rating, user) and pagination.
Use giphy_translate for one best-match GIF and giphy_trending for popular content.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): Search term or phrase, up to 50 characters. Add @username to search one verified channel. Example: cheeseburgers.
- `bundle` (`string`, optional): Return only the renditions in this bundle, for smaller responses, e.g. messaging_non_clips. Example: messaging_non_clips.
- `channel_ids` (`string`, optional): Only results from these channel IDs, comma-separated, up to 5. Example: 5,6.
- `country_code` (`string`, optional): End user's country, two-letter ISO 3166-1 code. Example: US.
- `customer_id` (`string`, optional): Stable, non-personal ID of the end user in your app, used by GIPHY to personalize results; use the random_id from giphy_random_id_create if you have none. Example: e826c9fc5c929e0d6c6d423841a282aa.
- `kind` (`string`, optional): Content type: gifs (default) or stickers (transparent GIFs). One of: `gifs`, `stickers`. Default: `gifs`.
- `lang` (`string`, optional): Two-letter ISO 639-1 language of the query, for regional content. Example: es.
- `limit` (`integer`, optional): Maximum number of results (default 25, max 50). Example: 10.
- `offset` (`integer`, optional): Number of results to skip, for paging (default 0). Example: 10.
- `rating` (`string`, optional): Highest content rating to return: g, pg, pg-13 or r. Leave empty for all ratings. One of: `g`, `pg`, `pg-13`, `r`.
- `region` (`string`, optional): End user's country subdivision, ISO 3166-2 code; use with country_code. Example: VA.
- `remove_low_contrast` (`boolean`, optional): true leaves out low-contrast items.

Example input: `{"q":"<q>"}`

### `giphy_tags_autocomplete`

Autocomplete Tags · Read-only

Suggest GIPHY tag terms that complete a partial tag.
Returns data[] of terms (name).
Use giphy_related_tags_list for related terms and giphy_search to search with a term.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): Partial tag term. Example: foo.
- `customer_id` (`string`, optional): Stable, non-personal ID of the end user in your app, used by GIPHY to personalize results; use the random_id from giphy_random_id_create if you have none. Example: e826c9fc5c929e0d6c6d423841a282aa.
- `limit` (`integer`, optional): Maximum number of results (default 5, max 50). Example: 10.
- `offset` (`integer`, optional): Number of results to skip, for paging (default 0). Example: 10.

Example input: `{"q":"<q>"}`

### `giphy_translate`

Translate To GIF · Read-only

Turn a word or phrase into the single best-matching GIF or sticker; use @ for a channel or # for a hashtag.
Returns data, one GIF object with id, title, url and images.
Use giphy_search for a list of results.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `s` (`string`, required): Word or phrase to translate into a GIF. Example: ryan gosling.
- `country_code` (`string`, optional): End user's country, two-letter ISO 3166-1 code. Example: US.
- `customer_id` (`string`, optional): Stable, non-personal ID of the end user in your app, used by GIPHY to personalize results; use the random_id from giphy_random_id_create if you have none. Example: e826c9fc5c929e0d6c6d423841a282aa.
- `kind` (`string`, optional): Content type: gifs (default) or stickers (transparent GIFs). One of: `gifs`, `stickers`. Default: `gifs`.
- `rating` (`string`, optional): Highest content rating to return: g, pg, pg-13 or r. Leave empty for all ratings. One of: `g`, `pg`, `pg-13`, `r`.
- `region` (`string`, optional): End user's country subdivision, ISO 3166-2 code; use with country_code. Example: VA.

Example input: `{"s":"<s>"}`

### `giphy_trending`

Get Trending GIFs · Read-only

Get today's trending GIFs or stickers on GIPHY.
Returns data[] of GIF objects (id, title, url, images, rating) and pagination.
Use giphy_search to search by keyword.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bundle` (`string`, optional): Return only the renditions in this bundle, for smaller responses, e.g. messaging_non_clips. Example: messaging_non_clips.
- `country_code` (`string`, optional): End user's country, two-letter ISO 3166-1 code. Example: US.
- `customer_id` (`string`, optional): Stable, non-personal ID of the end user in your app, used by GIPHY to personalize results; use the random_id from giphy_random_id_create if you have none. Example: e826c9fc5c929e0d6c6d423841a282aa.
- `kind` (`string`, optional): Content type: gifs (default) or stickers (transparent GIFs). One of: `gifs`, `stickers`. Default: `gifs`.
- `limit` (`integer`, optional): Maximum number of results (default 25, max 50). Example: 10.
- `offset` (`integer`, optional): Number of results to skip, for paging (default 0). Example: 10.
- `rating` (`string`, optional): Highest content rating to return: g, pg, pg-13 or r. Leave empty for all ratings. One of: `g`, `pg`, `pg-13`, `r`.
- `region` (`string`, optional): End user's country subdivision, ISO 3166-2 code; use with country_code. Example: VA.

Example input: `{}`

### `giphy_trending_searches_list`

List Trending Searches · Read-only

Get the most popular search terms on GIPHY right now.
Returns data[], a list of search term strings.
Use a term with giphy_search.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `customer_id` (`string`, optional): Stable, non-personal ID of the end user in your app, used by GIPHY to personalize results; use the random_id from giphy_random_id_create if you have none. Example: e826c9fc5c929e0d6c6d423841a282aa.

Example input: `{}`

### `giphy_random_id_create`

Create Random ID · Write

Generate a random, non-personal user identifier from GIPHY.
Returns data.random_id.
Pass it as customer_id on other GIPHY tools for consistent, personalized results.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs: none.

Example input: `{}`

## Related

Other Media connectors ([all 65](/agentkit/connectors/?category=media)):

- [Spotify](/agentkit/connectors/spotify/): Scalekit connector, OAuth, 47 tools
- [Reddit](/agentkit/connectors/reddit/): Scalekit connector, OAuth, 105 tools
- [Diarize](/agentkit/connectors/diarize/): Scalekit connector, Access token, 3 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
