skills.rest
xu1713
xu1713COMMUNITY
Explore all skills by this author →
GitHub

gif-search

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

Updated Jun 5, 2026
Search Tags:#api#search#media#gif#download#curl#tenor
One-click install
npx skills add https://github.com/xu1713/openhorse --skill gif-search-xu1713
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gif-search
Source: https://github.com/xu1713/openhorse/tree/main/openhorse/openhorse/skills/media/gif-search
Command: npx skills add https://github.com/xu1713/openhorse --skill gif-search-xu1713

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding and downloading GIFs for chat messages, reaction content, or visual media 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 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 chat. Search for "thumbs up", grab the lightweight 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, then parse the JSON response with jq. GIF URLs are available under .results[].media_formats.gif.url.

How do I download a GIF from the command line?▼

Search the Tenor API with curl, extract the top result's GIF URL using jq, then download it with curl -sL to a local file. The whole flow works as a single shell pipeline.

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

You need a TENOR_API_KEY environment variable containing a Google Cloud Console Tenor API key. The key is free with generous rate limits and can be obtained from the Google Tenor quickstart page.

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 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 restricting results too aggressively.

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
caiazzopcaiazzop

gifgrep

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

Community
Intermediate