gif-search

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

1|Updated Jun 9, 2026

Search Tags:#search #gif #download #curl #Tenor API

Ready to run

npx skills add https://github.com/aivos-xie/hermes-skills --skill gif-search-aivos-xie

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: gif-search
Source: https://github.com/aivos-xie/hermes-skills/tree/main/media/gif-search
Command: npx skills add https://github.com/aivos-xie/hermes-skills --skill gif-search-aivos-xie

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, jq, and includes scripts (resource) components.

What problem does it solve?

Searching for and downloading GIFs can be time-consuming. This Skill simplifies the process by using curl and jq to directly access the Tenor API.

Core Features & Use Cases

Search GIFs: Use the Tenor API to search for GIFs based on a query.
Download GIFs: Download GIFs directly from the search results.
Get Metadata: Retrieve detailed information about each GIF, including title, URL, preview, and dimensions.
Use Case: Easily find and share the perfect reaction GIF with friends or for use in social media.

Quick Start

Search for and download a GIF by running the following command:

# Search and download a GIF
curl -s "https://tenor.googleapis.com/v2/search?q=funny&limit=1&key=${TENOR_API_KEY}" | jq -r '.results[0].media_formats.gif.url' | curl -sL -o fun.gif

Frequently Asked Questions about gif-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I search and download GIFs from the command line?▼

You can search and download GIFs from the command line by using curl to query the Tenor API and jq to parse the JSON response. This approach directly fetches animated content and saves it locally without needing a web browser.

How does curl and jq retrieve GIF metadata from the Tenor API?▼

Curl sends an HTTP request to the Tenor API, and jq parses the returned JSON data to extract GIF metadata. This includes details like titles, URLs, previews, and dimensions for each available animated file.

Do I need a Tenor API key to search for GIFs with curl?▼

Yes, accessing the Tenor API to search for GIFs requires a valid Tenor API key. You must include this key in your curl request URL to successfully retrieve JSON data for downloading animated content.

What is the best way to automate GIF downloads for a chatbot?▼

Using curl and jq to access the Tenor API is an effective way to automate GIF downloads for chatbots. It quickly retrieves and parses animated content URLs, allowing your application to programmatically fetch reaction GIFs.

What are the limitations of using bash scripts for GIF search?▼

Using bash scripts with curl and jq limits GIF search to basic text queries and JSON parsing. It relies entirely on the Tenor API's rate limits and requires both command-line tools to be properly installed in your environment.