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
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. 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>Create the GIPHY connection
In AgentKit > Connections, create a GIPHY connection. The name you give it is the
connection_nameyour code passes. See Configure connections.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.actionsconst connector = 'giphy'const identifier = 'user_123'// Generate an authorization link for the userconst { 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 callconst result = await actions.executeTool({connector,identifier,toolName: 'giphy_categories_list',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_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.actionsconnection_name = "giphy"identifier = "user_123"# Generate an authorization link for the userlink_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 callresult = actions.execute_tool(tool_input={},tool_name="giphy_categories_list",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach 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 toexecute_toolgiphy_categories_listList GIPHY's GIF categories with their subcategories.Read-onlyList 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_channels_searchSearch GIPHY channels (brands, artists and creators) by name.Read-onlySearch Channels
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.
Inputs
qstringrequired- Term to search channels for. Example: nba.
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_listList GIPHY's animated emoji.Read-onlyList 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-onlyList 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-onlyGet 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-onlyGet 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-onlyGet 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
gifsstickersdefaultgifs 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.
giphy_searchSearch GIPHY's library of GIFs or stickers for a word or phrase; start q with @username to search one channel.Read-onlySearch GIFs
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.
Inputs
qstringrequired- Search term or phrase, up to 50 characters. Add @username to search one verified channel. Example: cheeseburgers.
bundlestring- Return only the renditions in this bundle, for smaller responses, e.g. messaging_non_clips. Example: messaging_non_clips.
channel_idsstring- Only results from these channel IDs, comma-separated, up to 5. Example: 5,6.
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
gifsstickersdefaultgifs langstring- Two-letter ISO 639-1 language of the query, for regional content. Example: es.
limitinteger- Maximum number of results (default 25, max 50). Example: 10.
offsetinteger- Number of results to skip, for paging (default 0). Example: 10.
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.
remove_low_contrastboolean- true leaves out low-contrast items.
giphy_translateTurn a word or phrase into the single best-matching GIF or sticker; use @ for a channel or # for a hashtag.Read-onlyTranslate To GIF
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.
Inputs
sstringrequired- Word or phrase to translate into a GIF. Example: ryan gosling.
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
gifsstickersdefaultgifs 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_trendingGet today's trending GIFs or stickers on GIPHY.Read-onlyGet Trending GIFs
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.
Inputs
bundlestring- Return only the renditions in this bundle, for smaller responses, e.g. messaging_non_clips. Example: messaging_non_clips.
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
gifsstickersdefaultgifs limitinteger- Maximum number of results (default 25, max 50). Example: 10.
offsetinteger- Number of results to skip, for paging (default 0). Example: 10.
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_trending_searches_listGet the most popular search terms on GIPHY right now.Read-onlyList Trending Searches
Get the most popular search terms on GIPHY right now. Returns data[], a list of search term strings. Use a 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_random_id_createGenerate a random, non-personal user identifier from GIPHY.WriteCreate Random ID
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.
Inputs
This tool takes no inputs.
No tools match.