skills.rest
ShineBreaker
ShineBreakerCOMMUNITY
Explore all skills by this author →
GitHub

gif-search

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

2|Updated Jan 2, 2026
Search Tags:#api#search#media#gif#download#curl#tenor
One-click install
npx skills add https://github.com/ShineBreaker/Guix-configs --skill gif-search-shinebreaker
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gif-search
Source: https://github.com/ShineBreaker/Guix-configs/tree/main/dotfiles/mutable/agents/hermes/.local/share/hermes/skills/.archive/gif-search
Command: npx skills add https://github.com/ShineBreaker/Guix-configs --skill gif-search-shinebreaker

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding and downloading GIFs for chat messages, documentation, or visual content usually requires manual browsing on GIF websites. 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 the top search result and save it 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 a chat message. Search for "thumbs up", grab the lightweight tinygif URL, and embed it directly in markdown. ## Quick Start Set the 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.

How do I get a Tenor API key for GIF search?▼

Register for a free key through the Google Cloud Console following the Tenor quickstart guide at developers.google.com/tenor. Set it as the TENOR_API_KEY environment variable before running searches.

What GIF formats does the Tenor API support?▼

Tenor returns multiple media formats per result: gif for full quality, tinygif and nanogif for previews, plus mp4, tinymp4, and webm video versions. Use the media_filter parameter to restrict which formats are returned.

Why does my Tenor API search return an error?▼

Errors usually come from a missing or invalid TENOR_API_KEY, or an unencoded query string. URL-encode spaces as plus signs and special characters as percent-encoded values, and verify the key is exported in your environment.

Can I control content safety in Tenor GIF search results?▼

Yes, use the contentfilter parameter with values off, low, medium, or high to filter results by safety level. You can also set the locale parameter to localize results for languages like en_US, es, or fr.

Related Skills

Explore More Content & Communication Skills→
ragnarokhaaragnarokhaa
4

gif-search

Searches and downloads GIFs from the Tenor API by query and format.

Community
Basic
anxiety135790anxiety135790

gif-search

Search Tenor for GIFs and return direct media URLs.

Community
Basic
OpenLoafOpenLoaf
94

media-ops-skill

Process local media files and download public videos for editing.

Official
Intermediate
0xHoneyJar0xHoneyJar
5

gifgrep

Search Tenor and Giphy GIFs via CLI or TUI, then download or extract frames.

Official
Intermediate