skills.rest
CHENHUI-X
CHENHUI-XCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

gif-search

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

Updated Jul 3, 2026
Search Tags:#api#search#gif#download#jq#curl#tenor
One-click install
npx skills add https://github.com/CHENHUI-X/toolbox --skill gif-search-chenhui-x
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gif-search
Source: https://github.com/CHENHUI-X/toolbox/tree/main/official-skills/media/gif-search
Command: npx skills add https://github.com/CHENHUI-X/toolbox --skill gif-search-chenhui-x

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding and downloading GIFs for chat messages, reactions, or visual content usually requires manual browsing. This Skill lets you search the Tenor API and retrieve GIF URLs or files directly from the command line. ## 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 and save the top search result as a local GIF file with curl. - Metadata Retrieval: Extract titles, preview URLs, and dimensions for search results using jq. - Use Case: You want to send a reaction GIF in chat. Search for "thumbs up", grab the tinygif URL, and embed it directly in a markdown message. ## Quick Start Set your TENOR_API_KEY environment variable, then ask the agent to search Tenor for a celebration GIF and download the top result.

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 to 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 GIF URL with jq, then run curl -sL with the URL and an output filename. The skill demonstrates downloading the top search result in a two-step shell command.

What API key do I need for Tenor GIF search?▼

You need a free Tenor API key from the Google Cloud Console, set as the TENOR_API_KEY environment variable. Google provides generous rate limits for the Tenor API at no cost.

What GIF formats does the Tenor API return?▼

Each result includes multiple media formats: gif for full quality, tinygif for small previews, mp4 and tinymp4 for video versions, webm, and nanogif for tiny thumbnails. Use the media_filter parameter to restrict returned formats.

Why does my Tenor API search return no results?▼

Check that your TENOR_API_KEY is set correctly and that the query is URL-encoded with spaces as plus signs. Also verify the contentfilter parameter is not set too restrictively for your search terms.

Related Skills

Explore More Content & Communication Skills→
1thirteeng31thirteeng3

gif-search

Search Tenor GIFs by keyword and fetch the top result with curl and jq.

Community
Basic
BermudaLocalsBermudaLocals
1

gif-search

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

Community
Basic
zamansepeti43zamansepeti43

video-edit

Edits videos locally with ffmpeg commands for trimming, resizing, compressing, and converting.

Community
Intermediate
winsorllcwinsorllc

gifgrep

Search GIPHY and Tenor for GIFs, download them, and extract frames.

Community
Intermediate