gif-search

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

5|2|Updated May 26, 2026
One-click install
npx skills add https://github.com/perasyudha/Nyxora --skill gif-search-perasyudha
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gif-search
Source: https://github.com/perasyudha/Nyxora/tree/main/packages/core/playbooks/media/gif-search
Command: npx skills add https://github.com/perasyudha/Nyxora --skill gif-search-perasyudha

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 a single pipeline. - Metadata Retrieval: Extract titles, preview URLs, and dimensions for each result using jq. - Use Case: You want to send a reaction GIF in chat. Search for "thumbs up", grab the lightweight tinygif URL, and embed it directly in markdown. ## 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. Pipe the JSON response through jq to extract GIF URLs from the media_formats field of each result.

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

Register for a free key through the Google Cloud Console by enabling the Tenor API, following the quickstart guide at developers.google.com/tenor. The free tier includes generous rate limits. Store the key in the TENOR_API_KEY environment variable.

What GIF formats does the Tenor API return?

Each result includes multiple formats under media_formats: gif for full quality, tinygif for small previews, mp4 and tinymp4 for video versions, webm, and nanogif for tiny thumbnails. Use tinygif URLs for lightweight chat embedding.

Why is my Tenor API search returning 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, and that your limit is between 1 and 50.

Can I filter Tenor GIF results by content safety?

Yes, the contentfilter parameter accepts off, low, medium, or high values to control safety levels. You can also use the locale parameter to localize results and media_filter to restrict returned formats.