gif-search

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

6|1|Updated May 11, 2026
One-click install
npx skills add https://github.com/yakeworld/Synthos --skill gif-search-yakeworld
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gif-search
Source: https://github.com/yakeworld/Synthos/tree/main/skills/extended/external-automation/automation-skills/media/gif-search
Command: npx skills add https://github.com/yakeworld/Synthos --skill gif-search-yakeworld

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding and downloading GIFs for chat messages, documentation, or visual content usually requires manual browsing. This Skill lets you search the Tenor GIF library and retrieve or download GIF URLs directly from the command line with curl. ## Core Features & Use Cases - GIF Search via Tenor API: Query the Tenor v2 search endpoint with parameters for result limits, content safety filters, locale, and media format selection. - Multiple Media Formats: Retrieve full-quality GIFs, lightweight tinygif previews, MP4/WebM video variants, or thumbnails depending on bandwidth and use case. - Direct Download & Embedding: Download GIF files locally with curl or embed returned URLs directly in Markdown using standard image syntax. - Use Case: You want to send a reaction GIF in a chat message. Search for "thumbs up", extract the tinygif URL with jq, and paste the lightweight URL directly into the conversation. ## Quick Start Set the TENOR_API_KEY environment variable and ask the agent to search Tenor for a celebration GIF and give me the URL.

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 in the q parameter, a limit between 1 and 50, and your API key. Extract GIF URLs from the response using jq with the path .results[].media_formats.gif.url.

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

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

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 file size. Use tinygif for chat messages and Markdown embedding where bandwidth matters, and gif for full-quality downloads.

Why does my Tenor API request return a 401 or 403 error?

A 401 or 403 response means the API key is missing or invalid. Verify the TENOR_API_KEY environment variable is set correctly and that the key is active in your Google Cloud Console project.

How do I download a GIF file from the Tenor API to my computer?

First search the API and extract the media_formats.gif.url value with jq, then download it with curl -sL followed by the URL and an output filename such as -o celebration.gif.