gif-search

Search Tenor's v2 API and extract GIF or tinygif URLs.

1|Updated Apr 14, 2026
One-click install
npx skills add https://github.com/eddielueng/hermes-agent-zh --skill gif-search-eddielueng
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gif-search
Source: https://github.com/eddielueng/hermes-agent-zh/tree/main/skills/media/gif-search
Command: npx skills add https://github.com/eddielueng/hermes-agent-zh --skill gif-search-eddielueng

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Searching for the right reaction or visual can be slow when you have to browse sites manually and then figure out which links to use in chat.

Core Features & Use Cases

  • Tenor search via API: Query Tenor for GIFs by keyword and get direct URLs suitable for messaging.
  • Choose the right format: Select full GIFs for quality or smaller preview formats for lighter sharing.
  • Metadata retrieval: Fetch titles, URLs, preview links, and dimensions for better selection and formatting.
  • Use case: You want a thumbs-up reaction for a team chat; search “thumbs up” and pick a tiny preview GIF to keep messages fast.

Quick Start

Search Tenor for the GIFs matching the phrase "celebration" and return the download URL for the top result using your TENOR_API_KEY.

Frequently Asked Questions about gif-search

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

FAQPage Schema
How do I search Tenor for GIFs and get a direct URL for chat reactions?

To search Tenor for GIFs, you query the Tenor v2 search endpoint using curl and jq with a valid TENOR_API_KEY. The process parses results.media_formats to extract direct gif or tinygif URLs and metadata for immediate use in chat reactions.

Do I need an API key to search for Tenor GIFs programmatically?

Yes, searching Tenor GIFs requires a TENOR_API_KEY for authenticated requests to the Tenor v2 search endpoint. You must supply this key in your curl request to successfully retrieve GIF URLs and metadata.

What's the best way to get lightweight GIF previews for fast messaging workflows?

For lightweight GIF previews in fast messaging workflows, parse the tinygif format from the Tenor API results.media_formats. Selecting tinygif URLs instead of full gif formats reduces payload size and keeps messages efficient.

Can I retrieve GIF dimensions and metadata using a Tenor search API request?

Yes, you can retrieve GIF dimensions and metadata using a Tenor search API request. Querying the endpoint with curl and jq parses the API response to extract titles, URLs, preview links, and dimensions for better selection and formatting.

How does selecting tinygif versus full gif formats affect Tenor search results?

Selecting tinygif formats from Tenor search results yields smaller preview images optimized for speed, while full gif formats provide higher quality visual content. The choice depends on whether you prioritize bandwidth efficiency or visual clarity.

What tools are required to query Tenor and parse media URLs from the response?

You need curl and jq to query Tenor and parse media URLs from the response. Curl handles the authenticated HTTP requests to the Tenor v2 search endpoint, while jq parses the JSON output to extract gif and tinygif URLs from results.media_formats.