Sticker Search

Searches for stickers on Giphy using a query term or phrase. Stickers are animated images with transparent backgrounds, perfect for overlaying on photos, messages, or other content. This node works identically to GIF search but returns sticker content.

Common Properties

• Name - The custom name of the node.
• Color - The custom color of the node.
• Delay Before (sec) - Waits in seconds before executing the node.
• Delay After (sec) - Waits in seconds after executing node.
• Continue On Error - Automation will continue regardless of any error. The default value is false.

info

If the ContinueOnError property is true, no error is caught when the project is executed, even if a Catch node is used.

Inputs

• Q - Search query term or phrase. This is a required field and cannot be empty. Use specific keywords for better results (e.g., "heart", "thumbs up", "emoji", "reaction").

Options

• Limit - The maximum number of stickers to return. Default: 25. Maximum recommended: 50.
• Offset - Results offset for pagination. Default: 0. Use for browsing through results.
• Rating - Content rating filter. Options:
  • g - Suitable for all audiences (default)
  • pg - Parental guidance suggested
  • pg-13 - Parents strongly cautioned
  • r - Restricted to adults
• Language - Language code for localized results. Default: en (English). Supports 30+ languages.
• Bundle - Rendering optimization type. Options:
  • Efficient Clip Grid - Optimized for grid display
  • Quick GIFs - Fast-loading (default)
  • Efficient Sticker Layering - Optimized for sticker overlays
  • Low Data Usage GIFs - Smaller file sizes
• API Key - Your Giphy API key credential for authentication. Required for all requests.

Output

• resp - API response object containing:
  • data - Array of sticker objects with URLs, metadata, and transparent backgrounds
  • pagination - Object with total_count, count, and offset
  • meta - API status information

How It Works

1. Validates that the search query is not empty
2. Retrieves authentication credentials
3. Constructs API request with query parameters
4. Sends GET request to Giphy's sticker search endpoint
5. Returns matching stickers with transparent backgrounds
6. Each sticker includes multiple size and format options

Example Usage

Basic Sticker Search

msg.Q = "thumbs up";
msg.Limit = 10;
// Get thumbs up stickers with transparent backgrounds

Search for Emoji-Style Stickers

msg.Q = "happy face emoji";
msg.Limit = 20;
msg.Rating = "g";
// Get family-friendly emoji stickers

Messaging Stickers

msg.Q = "good morning";
msg.Bundle = "messaging_non_clips";
// Get stickers optimized for messaging apps

Reaction Stickers

let reactions = ["love", "wow", "haha", "sad", "angry"];
msg.stickerPacks = {};

for (let reaction of reactions) {
    msg.Q = reaction;
    msg.Limit = 5;
    // Run Sticker Search
    msg.stickerPacks[reaction] = msg.resp.data;
}

Common Use Cases

1. Chat Applications - Provide stickers for messaging and chat features
2. Photo Editing - Overlay stickers on photos and images
3. Social Media - Add stickers to stories, posts, and comments
4. Email Enhancement - Include stickers in HTML emails
5. Video Overlays - Add animated stickers to videos
6. Reaction Systems - Create sticker-based reaction features
7. Digital Cards - Use stickers to decorate e-cards and greetings

Stickers vs GIFs

Feature	Stickers	GIFs
Background	Transparent	Opaque
Use Case	Overlay on content	Standalone media
File Size	Often smaller	Often larger
Best For	Reactions, decorations	Full content, memes

Tips

• Transparent Backgrounds - All stickers have transparent backgrounds for overlaying
• Search Terms - Use terms like "emoji", "icon", "reaction" for sticker-appropriate results
• Bundle Selection - Use "sticker_laying" bundle for best overlay performance
• Size Formats - Stickers include multiple sizes optimized for different uses
• Messaging Apps - Stickers are ideal for WhatsApp, Telegram, Discord integrations
• Combine with Photos - Layer stickers over user photos for enhanced UX
• Seasonal Content - Search seasonal terms ("christmas", "halloween") for themed stickers

Response Structure

{
  "data": [
    {
      "type": "gif",
      "id": "sticker_id",
      "url": "https://giphy.com/stickers/...",
      "images": {
        "original": {
          "url": "https://media.giphy.com/.../giphy.gif",
          "width": "480",
          "height": "480",
          "has_transparency": true
        },
        "downsized": { ... },
        "fixed_height": { ... }
      },
      "title": "Sticker Title",
      "rating": "g"
    }
  ],
  "pagination": {
    "total_count": 250,
    "count": 25,
    "offset": 0
  },
  "meta": {
    "status": 200,
    "msg": "OK"
  }
}

Best Practices

1. Always verify transparency support in your application
2. Use appropriate size formats for your use case (smaller for messaging)
3. Implement pagination for large result sets
4. Cache popular sticker searches to improve performance
5. Test sticker rendering on various backgrounds
6. Provide preview before applying stickers
7. Consider file size when selecting sticker formats

Popular Sticker Search Terms

• Emotions: happy, sad, love, angry, surprised, confused
• Reactions: yes, no, thumbs up, applause, facepalm, shrug
• Greetings: hello, goodbye, thank you, welcome, good morning
• Emojis: heart, star, fire, sparkle, celebration
• Symbols: check, x, arrow, crown, trophy
• Seasonal: christmas, halloween, birthday, valentine