skills.rest
episvr
episvrCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

gif-search

Search and download GIFs from the Tenor API using curl and jq.

Updated Jul 7, 2026
Search Tags:#API#search#media#gif#download#curl#tenor
One-click install
npx skills add https://github.com/episvr/USTB-2026-SummerInternship --skill gif-search-episvr
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gif-search
Source: https://github.com/episvr/USTB-2026-SummerInternship/tree/main/hermes-config/skills/media/gif-search
Command: npx skills add https://github.com/episvr/USTB-2026-SummerInternship --skill gif-search-episvr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding and downloading GIFs for chat messages, reaction content, or visual assets normally requires manual browsing on GIF websites. This Skill lets you search and retrieve GIFs directly from the command line via the Tenor API. ## Core Features & Use Cases - GIF Search: Query the Tenor API with keywords and retrieve GIF URLs in multiple formats (gif, tinygif, mp4, webm). - Direct Download: Fetch the top search result and save it as a local GIF file with a single curl pipeline. - Metadata Retrieval: Extract titles, preview URLs, and dimensions for each result using jq filters. - Use Case: You want to send a celebration GIF in a chat message. Run the search command with your query, grab the tinygif URL, and embed it directly in markdown. ## Quick Start Set the TENOR_API_KEY environment variable, then ask the AI to search Tenor for a reaction GIF and return the top result URL.

Frequently Asked Questions about gif-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search for GIFs using the Tenor API?▼

Send a GET request to https://tenor.googleapis.com/v2/search with your query, limit, and API key parameters using curl. Pipe the JSON response through jq to extract GIF URLs from the media_formats field of each result.

How to download a GIF from the command line with curl?▼

First query the Tenor search endpoint and extract the top result's gif URL with jq, then pass that URL to curl -sL with an output filename. The GIF downloads directly to your local directory.

What is the difference between gif and tinygif formats in Tenor?▼

The gif format is the full-quality version, while tinygif is a smaller preview version with reduced file size. Use tinygif URLs for chat messages where lighter weight matters, and gif for full-quality downloads.

Why does my Tenor API request return an error?▼

Errors usually occur when the TENOR_API_KEY environment variable is unset or invalid, or when the query is not URL-encoded. Encode spaces as plus signs and verify your key from the Google Cloud Console Tenor API page.

Can I filter Tenor GIF results by content safety level?▼

Yes, the Tenor API supports a contentfilter parameter with values off, low, medium, or high. Add it to your search request URL to control the safety level of returned results.

Related Skills

Explore More Content & Communication Skills→
christian-byrnechristian-byrne

gif-search

Search and download GIFs from the Tenor API using curl and jq.

Community
Basic
unclehowellunclehowell

gif-search

Search Tenor API and download GIF media URLs using curl and jq.

Community
Basic
bytedancebytedance
417

image-video-gen

Coordinate web-search, image-generate, and video-generate tools to create storyboard images and videos.

Official
Intermediate
winsorllcwinsorllc

gif-search

Search animated GIFs via GIPHY and Tenor APIs and return URLs.

Community
Intermediate