skills.rest
ossoolli
ossoolliCOMMUNITY
Explore all skills by this author →
GitHub

gif-search

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

Updated May 18, 2026
Search Tags:#search#media#gif#download#jq#curl#tenor
One-click install
npx skills add https://github.com/ossoolli/Nexum-Core --skill gif-search-ossoolli
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gif-search
Source: https://github.com/ossoolli/Nexum-Core/tree/main/skills/media/gif-search
Command: npx skills add https://github.com/ossoolli/Nexum-Core --skill gif-search-ossoolli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding and downloading GIFs for chat messages, reaction content, or visual assets 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 with curl and jq. ## Core Features & Use Cases - GIF Search: Query the Tenor v2 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 in one pipeline. - Metadata Retrieval: Extract titles, preview URLs, and dimensions for each result. - 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 parameters q (query), limit, and key. Pipe the JSON response through jq to extract GIF URLs from .results[].media_formats.gif.url.

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 "$URL" -o filename.gif to save the file locally. The -L flag follows redirects from the media CDN.

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

The gif format is the full-quality animation, while tinygif is a smaller preview version with reduced dimensions and file size. Use tinygif URLs for chat messages where lighter payloads load faster.

Do I need an API key to use the Tenor GIF search?▼

Yes, the Tenor v2 API requires a key passed as the key parameter. You can obtain a free key from the Google Cloud Console by enabling the Tenor API, and it should be stored in the TENOR_API_KEY environment variable.

What are the rate limits and result limits for Tenor API search?▼

The limit parameter accepts values from 1 to 50 results per request, with a default of 20. The free Google Cloud Tenor API key includes generous rate limits suitable for typical interactive usage.

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
michaelboedingmichaelboeding
24

social-producer-agent

Generate and assemble multi-asset social media content packs from prompts.

Community
Advanced
0xHoneyJar0xHoneyJar
5

gifgrep

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

Official
Intermediate