Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to GIPHY

Scalekit connector
Open markdown

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.

Tools
14
What they doRead · write · destructive
13 · 1 · 013 read1 write0 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

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

  4. Authorize a user and make your first call

    quickstart.mts
    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)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their GIPHY credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • giphy_categories_listList GIPHY's GIF categories with their subcategories.Read-only

    List Categories

    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.

    Inputs

    customer_idstring
    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.
  • giphy_emoji_listList GIPHY's animated emoji.Read-only

    List Emoji

    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.

    Inputs

    customer_idstring
    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.
    limitinteger
    Maximum number of results (default 25, max 50). Example: 10.
    offsetinteger
    Number of results to skip, for paging (default 0). Example: 10.
  • giphy_emoji_variations_listList the variations (skin tones or styles) of a GIPHY emoji.Read-only

    List Emoji Variations

    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.

    Inputs

    gif_idstringrequired
    GIPHY ID of the emoji. Example: dalJ0CpF7hwmN1nZXe.
    customer_idstring
    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.
  • giphy_gif_getGet one GIF's metadata by its GIPHY ID.Read-only

    Get GIF

    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.

    Inputs

    gif_idstringrequired
    GIPHY ID of the GIF. Example: xT4uQulxzV39haRFjG.
    country_codestring
    End user's country, two-letter ISO 3166-1 code. Example: US.
    customer_idstring
    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.
    ratingstring
    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 gpgpg-13r
    regionstring
    End user's country subdivision, ISO 3166-2 code; use with country_code. Example: VA.
  • giphy_gifs_getGet the metadata of up to 100 GIFs by their GIPHY IDs.Read-only

    Get GIFs By IDs

    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.

    Inputs

    idsstringrequired
    GIPHY GIF IDs, comma-separated, up to 100. Example: xT4uQulxzV39haRFjG,3og0IPxMM0erATueVW.
    country_codestring
    End user's country, two-letter ISO 3166-1 code. Example: US.
    customer_idstring
    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.
    ratingstring
    Highest content rating to return: g, pg, pg-13 or r. Leave empty for all ratings.one of gpgpg-13r
    regionstring
    End user's country subdivision, ISO 3166-2 code; use with country_code. Example: VA.
  • giphy_randomGet one random GIF or sticker, optionally related to a tag.Read-only

    Get Random GIF

    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.

    Inputs

    country_codestring
    End user's country, two-letter ISO 3166-1 code. Example: US.
    customer_idstring
    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.
    kindstring
    Content type: gifs (default) or stickers (transparent GIFs).one of gifsstickersdefault gifs
    ratingstring
    Highest content rating to return: g, pg, pg-13 or r. Leave empty for all ratings.one of gpgpg-13r
    regionstring
    End user's country subdivision, ISO 3166-2 code; use with country_code. Example: VA.
    tagstring
    Only a GIF with this tag. Leave empty for any GIF. Example: burrito.