gif-search

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

Updated Aug 21, 2026
One-click install
npx skills add https://github.com/TylerSimons1127/vibe --skill gif-search-tylersimons1127
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gif-search
Source: https://github.com/TylerSimons1127/vibe/tree/main/skills/media/gif-search
Command: npx skills add https://github.com/TylerSimons1127/vibe --skill gif-search-tylersimons1127

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding and downloading GIFs for chat reactions or visual content normally requires manual browsing; this Skill retrieves GIF URLs and files directly from the Tenor API via 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. - Use Case: You want a reaction GIF for a chat message. Search Tenor for "celebration", grab the tinygif URL, and embed it directly in markdown. ## Quick Start Search Tenor for a thumbs up GIF and give me the URL of 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, then parse the JSON response with jq to extract URLs from .results[].media_formats.gif.url. URL-encode spaces in the query as + characters.

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 on that URL with -o to save the file locally. The Skill shows a one-liner that downloads the top search result.

Where do I get a Tenor API key?▼

Get a free Tenor API key from the Google Cloud Console by following the Tenor quickstart guide at developers.google.com/tenor. Set it as the TENOR_API_KEY environment variable before running searches.

What media formats does the Tenor API return?▼

Each result includes gif, tinygif, mp4, tinymp4, webm, and nanogif formats under .media_formats. Use tinygif for lightweight chat previews and gif for full quality.

Why does my Tenor GIF search return no results?▼

Missing results usually come from an unset or invalid TENOR_API_KEY, unencoded special characters in the query, or a restrictive contentfilter setting. Verify the key is exported and URL-encode the query string.