Documentation - Emoji Favicon Service

⚡ Quick Start

Add an emoji favicon to any website with a single HTML tag:

<link rel="icon" href="https://emoji.findutils.com/fire">

The browser fetches the emoji as an SVG favicon. Works in Chrome, Firefox, Edge, and Safari (auto-serves PNG for Safari).

By name

https://emoji.findutils.com/rocket

By keyword

https://emoji.findutils.com/hot

By emoji

https://emoji.findutils.com/%F0%9F%94%A5

Covers all 3,773 emojis in Unicode, searchable by 11,550 keywords.

⚙️ URL Parameters

Customize any emoji endpoint with query parameters:

Parameter	Type	Default	Description
`size`	number	`48`	SVG size in pixels (16-512)
`bg`	hex	`none`	Background color, e.g. `ff6b6b`
`darkbg`	hex	`none`	Dark mode background color
`shape`	string	`square`	16 shapes: `square`, `circle`, `rounded`, `hexagon`, `diamond`, `shield`, `star`, `heart`, `triangle`, `pentagon`, `octagon`, `drop`, `egg`, `cross`, `cloud`, `badge`
`animate`	string	`none`	27 animations: `pulse`, `bounce`, `spin`, `shake`, `float`, `flip`, `tada`, `swing`, `wobble`, `heartbeat`, `jello`, `rubberband`, `flash`, `pop`, `squeeze`, `nod`, `glitch`, `breathe`, `rotate360`, `wave`, `zoom`, `blink`, `slide-in`, `rainbow`, `typing`, `bounce-in`, `attention`
`badge`	string	`none`	Notification badge: number (1-99) or `dot`
`theme`	string	`none`	18 branded themes: `github-dark`, `github-light`, `vercel-dark`, `stripe-blue`, `tailwind`, `react`, `vue`, `svelte`, `nextjs`, `nuxt`, `laravel`, `cloudflare`, `supabase`, `firebase`, `aws`, `dracula`, `nord`, `catppuccin`
`darkmode`	string	`none`	Emoji to show in dark mode (auto-detected via prefers-color-scheme)
`daytime`	string	`none`	Emoji to show during daytime (6am-6pm based on user timezone)
`random`	string	`none`	Comma-separated emojis to randomly rotate between
`svg`	flag	`-`	Force SVG format
`png`	flag	`-`	Force PNG format (Twemoji)
`og`	flag	`-`	Return 1200x630 OG image

Shapes Gallery

square

circle

rounded

hexagon

diamond

shield

star

heart

triangle

pentagon

octagon

drop

egg

cross

cloud

badge

Animations Gallery

pulse

bounce

spin

shake

float

flip

tada

swing

wobble

heartbeat

jello

rubberband

flash

pop

squeeze

nod

glitch

breathe

rotate360

wave

zoom

blink

slide-in

rainbow

typing

bounce-in

attention

Example:

https://emoji.findutils.com/fire?size=128&bg=1a1a2e&shape=hexagon&animate=tada

Try it ↗

🌐 Favicon Endpoint

GET /:emoji

Returns an SVG (or PNG for Safari) favicon for any emoji name, keyword, or character.

# By name
https://emoji.findutils.com/fire
https://emoji.findutils.com/red-heart
https://emoji.findutils.com/rocket

# Country flags
https://emoji.findutils.com/US
https://emoji.findutils.com/TR

# With customization
https://emoji.findutils.com/star?size=64&bg=ffd700&shape=circle

Response: image/svg+xml (or image/png for Safari).

Cache: CDN 7 days, browser 24 hours.

Try it ↗

🔥 Combo Emoji

GET /:emoji1+:emoji2+...+:emojiN

Combine 2 to 10 emojis side by side in a single favicon.

# Two emojis
https://emoji.findutils.com/fire+rocket

# Three emojis
https://emoji.findutils.com/heart+sparkles+star

# Five emojis
https://emoji.findutils.com/fire+rocket+star+heart+sparkles

# Up to 10 emojis max
https://emoji.findutils.com/coffee+laptop+gear+rocket+star+fire+bulb+chart+check+party

All URL parameters (shape, animation, background) work with combos:

https://emoji.findutils.com/fire+rocket+star?bg=1a1a2e&shape=rounded&animate=pulse

Try it ↗

🔴 Notification Badge

GET /:emoji?badge=N

Add a red notification badge overlay to any emoji favicon. Supports numeric counts (1-99) or a simple dot.

Parameter	Type	Default	Description
`badge`	string	`-`	Badge content: number (1-99) or `dot`

# Numeric badge
https://emoji.findutils.com/bell?badge=3

# Dot indicator
https://emoji.findutils.com/mail?badge=dot

# Works with all customization
https://emoji.findutils.com/chat?badge=12&shape=circle&bg=1a1a2e

Try it ↗

🔤 Text Favicon

GET /text/:chars

Generate a favicon from 1-3 text characters. Great for initials, version numbers, or short labels.

Parameter	Type	Default	Description
`:chars`	string	`-`	1-3 characters (letters, numbers)
`bg`	hex	`none`	Background color
`color`	hex	`fff`	Text color
`shape`	string	`rounded`	Background shape

# Initials
https://emoji.findutils.com/text/AB

# Version number
https://emoji.findutils.com/text/v2

# With styling
https://emoji.findutils.com/text/OK?bg=22c55e&shape=circle

Try it ↗

📚 Stacked Emoji

GET /stack/:bg+:fg

Layer one emoji on top of another. The first emoji is the background (larger), the second is the foreground (smaller, offset).

# Globe with fire overlay
https://emoji.findutils.com/stack/globe+fire

# Heart with star
https://emoji.findutils.com/stack/heart+star

# With customization
https://emoji.findutils.com/stack/circle+check?size=64&shape=rounded

Try it ↗

🎨 Branded Themes

GET /:emoji?theme=:name

Apply one of 18 developer brand presets. Each theme sets background color, shape, and styling to match the brand.

Parameter	Type	Default	Description
`theme`	string	`none`	Brand preset name

Available themes: github-dark, github-light, vercel-dark, stripe-blue, tailwind, react, vue, svelte, nextjs, nuxt, laravel, cloudflare, supabase, firebase, aws, dracula, nord, catppuccin

https://emoji.findutils.com/rocket?theme=github-dark
https://emoji.findutils.com/fire?theme=vercel-dark
https://emoji.findutils.com/star?theme=tailwind
https://emoji.findutils.com/heart?theme=dracula

Try it ↗

🌙 Conditional Favicons

GET /:emoji?darkmode=:emoji2

Automatically switch favicons based on user conditions: dark mode, time of day, or random selection.

Parameter	Type	Default	Description
`darkmode`	string	`-`	Emoji to show in dark mode (detected via `prefers-color-scheme`)
`daytime`	string	`-`	Emoji to show during daytime (6am-6pm user timezone)
`random`	string	`-`	Comma-separated emojis to randomly rotate between

# Dark mode: sun by default, moon in dark mode
https://emoji.findutils.com/sun?darkmode=moon

# Time-based: moon at night, sun during day
https://emoji.findutils.com/moon?daytime=sun

# Random rotation on each page load
https://emoji.findutils.com/fire?random=fire,rocket,star,heart

Try it ↗

🏷️ Badge Endpoint

GET /badge/:emoji

Shields.io-style SVG badges with emoji. Perfect for GitHub READMEs, docs, or status pages.

Parameter	Type	Default	Description
`:emoji`	string	`-`	Emoji name or keyword
`label`	string	`emoji name`	Left side text
`status`	string	`emoji name`	Right side text
`color`	string	`blue`	`green`, `red`, `yellow`, `blue`, or hex
`labelColor`	string	`#555`	Left side background hex
`style`	string	`rounded`	`rounded` or `flat`

![Build](https://emoji.findutils.com/badge/rocket?label=build&status=passing&color=green)
![Version](https://emoji.findutils.com/badge/package?label=version&status=2.1.0&color=blue)
![Deploy](https://emoji.findutils.com/badge/fire?label=deploy&status=live&color=ff6b6b)

Cache: 5 minutes.

Try it ↗

👤 Avatar Endpoint

GET /avatar/:identifier

Gravatar-style emoji avatars. Hash any string to a deterministic emoji + color. Same input always produces the same avatar.

Parameter	Type	Default	Description
`:identifier`	string	`-`	Email, username, or any string
`size`	number	`128`	Size in pixels
`shape`	string	`square`	`square`, `circle`, or `rounded`

<img src="https://emoji.findutils.com/avatar/user@example.com?shape=circle&size=64" />
<img src="https://emoji.findutils.com/avatar/deploy-bot?shape=rounded" />
<img src="https://emoji.findutils.com/avatar/jane.doe?size=32&shape=circle" />

Cache: CDN 30 days, browser 7 days (deterministic, never changes).

Try it ↗

📖 README Banner

GET /readme/:emoji

800x200 SVG banners for GitHub READMEs. Large emoji left, project title right.

Parameter	Type	Default	Description
`:emoji`	string	`-`	Emoji name or keyword
`title`	string	`emoji name`	Project title
`subtitle`	string	`none`	Subtitle text
`theme`	string	`dark`	`dark` or `light`

![Banner](https://emoji.findutils.com/readme/rocket?title=My+Awesome+Project&subtitle=Built+with+love)

Try it ↗

🟢 Status Icons

GET /status/:state

Predefined status icons for status pages and dashboards.

Parameter	Type	Default	Description
`:state`	string	`-`	`up`, `down`, `degraded`, `maintenance`
`emoji`	string	`default`	Override the default emoji
`size`	number	`32`	Icon size in pixels

/status/up Green circle

/status/down Red circle

/status/degraded Yellow circle

/status/maintenance Wrench

<img src="https://emoji.findutils.com/status/up" /> All systems operational
https://emoji.findutils.com/status/up?emoji=rocket

Cache: 1 minute.

Try it ↗

🖼️ OG Image

GET /:emoji?og=true

1200x630 SVG images for social media sharing (Twitter, Facebook, LinkedIn).

<meta property="og:image" content="https://emoji.findutils.com/fire?og=true" />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="630" />

Try it ↗

✉️ Email Signature

GET /sig/:emoji

PNG emoji for email signatures. Email clients can't render SVG, so this forces PNG via Twemoji.

<img src="https://emoji.findutils.com/sig/fire" width="20" height="20" style="vertical-align:middle" />

Cache: 24 hours.

Try it ↗

📦 Embed / oEmbed

GET /embed/:emoji

Minimal HTML page with centered emoji. For Notion embeds or iframes.

<iframe src="https://emoji.findutils.com/embed/fire" width="200" height="200" frameborder="0"></iframe>

GET /oembed?url=...

oEmbed discovery for rich embed previews:

https://emoji.findutils.com/oembed?url=https://emoji.findutils.com/embed/fire

Response

{
  "version": "1.0",
  "type": "rich",
  "provider_name": "Emoji Favicon",
  "title": "Fire",
  "width": 200,
  "height": 200
}

🏷️ Powered-By Badge

GET /badge/powered-by

"Powered by emoji.findutils.com" pill badge SVG. Use for attribution in your project.

<img src="https://emoji.findutils.com/badge/powered-by" alt="Powered by emoji.findutils.com" />

Try it ↗

🍎 Apple Touch Icon

GET /apple-touch-icon/:emoji

Generate a 180x180 PNG icon for iOS home screen. Add to your HTML head for iOS bookmark icons.

<link rel="apple-touch-icon" href="https://emoji.findutils.com/apple-touch-icon/rocket">

Try it ↗

📋 PWA Manifest

GET /manifest/:emoji

Auto-generate a manifest.json with all required icon sizes (192x192, 512x512). Link it in your HTML for instant PWA support.

<link rel="manifest" href="https://emoji.findutils.com/manifest/rocket">

Response

{
  "name": "Rocket",
  "icons": [
    { "src": "https://emoji.findutils.com/rocket?size=192", "sizes": "192x192", "type": "image/svg+xml" },
    { "src": "https://emoji.findutils.com/rocket?size=512", "sizes": "512x512", "type": "image/svg+xml" }
  ]
}

Try it ↗

📥 Favicon Download

GET /download/:emoji

Download a ZIP package containing all standard favicon sizes: 16x16, 32x32, 48x48, 64x64, 128x128, 192x192, and 512x512.

https://emoji.findutils.com/download/rocket

Response: application/zip with Content-Disposition: attachment.

Try it ↗

📋 Sprite Sheets

GET /sprite?emojis=:list

Generate a multi-emoji grid SVG sprite sheet. Useful for icon sets and batch rendering.

Parameter	Type	Default	Description
`emojis`	string	`-`	Comma-separated emoji names
`size`	number	`48`	Size of each emoji cell
`cols`	number	`auto`	Number of columns in the grid

https://emoji.findutils.com/sprite?emojis=fire,rocket,star,heart,sparkles

Try it ↗

👍 Reactions Embed

GET /react/:emoji

Embeddable reaction widget with per-domain click counters. Each website gets its own independent count. Domain is automatically detected from the Referer header, or you can set it explicitly with the ?site= parameter.

Quick Start

<!-- Add to any page — domain is auto-detected from Referer -->
<iframe src="https://emoji.findutils.com/react/thumbsup" width="80" height="100" frameborder="0"></iframe>
<iframe src="https://emoji.findutils.com/react/heart" width="80" height="100" frameborder="0"></iframe>
<iframe src="https://emoji.findutils.com/react/fire" width="80" height="100" frameborder="0"></iframe>

Explicit Domain

If Referer is not available (e.g. sandboxed iframes), pass the domain explicitly:

<iframe src="https://emoji.findutils.com/react/thumbsup?site=myblog.com" width="80" height="100" frameborder="0"></iframe>

Sub-Endpoints

GET /react/:emoji/count?site=domain

Get the current click count for an emoji on a specific domain.

curl https://emoji.findutils.com/react/thumbsup/count?site=myblog.com
# {"emoji_slug":"thumbsup","domain":"myblog.com","count":42}

POST /react/:emoji/click?site=domain

Increment the click count. Rate-limited to 1 click per IP, per emoji, per domain, per hour.

curl -X POST https://emoji.findutils.com/react/thumbsup/click?site=myblog.com
# {"emoji":"👍","slug":"thumbsup","domain":"myblog.com","count":43}

How It Works

Per-domain isolation — myblog.com and otherblog.com have separate counters
Domain detection — auto from Referer header, or explicit via ?site=
Rate limiting — in-memory, 1 click/hour per IP+emoji+domain
Client-side dedup — localStorage prevents repeat clicks in the same browser

Try it ↗

🔗 Link Preview

GET /preview/:url

Generate an OG-image-style preview card with emoji for any URL. Returns an SVG card with the site title and favicon.

https://emoji.findutils.com/preview/https://github.com

Try it ↗

🔀 A/B Testing

GET /ab/:emojiA/:emojiB

Randomly serve one of two emoji variants. Tracks which variant was served for analytics comparison.

# 50/50 split between fire and rocket
https://emoji.findutils.com/ab/fire/rocket

Response headers include X-Variant: A or X-Variant: B for tracking.

Try it ↗

🔍 Search API

GET /api/search?q=:query

Search emojis by name or keyword. Returns up to 20 results.

Parameter	Type	Default	Description
`q`	string	`-`	Search query (max 100 chars)

https://emoji.findutils.com/api/search?q=fire

Response

{
  "query": "fire",
  "results": [
    {
      "emoji": "\ud83d\udd25",
      "name": "Fire",
      "slug": "fire",
      "score": 100,
      "url": "https://emoji.findutils.com/fire"
    }
  ]
}

Cache: 1 hour.

Try it ↗

💡 Suggest API

GET /api/suggest

Get emoji suggestions for text or a URL. Analyzes content and returns the best matches.

Parameter	Type	Default	Description
`text`	string	`-`	Text to analyze
`url`	string	`-`	URL to fetch and analyze

# From text
https://emoji.findutils.com/api/suggest?text=cooking+blog+recipes

# From URL
https://emoji.findutils.com/api/suggest?url=https://example.com

Response

{
  "query": "cooking blog recipes",
  "suggestions": [
    { "emoji": "\ud83c\udf73", "name": "Cooking", "slug": "cooking", "score": 6 },
    { "emoji": "\ud83c\udf72", "name": "Pot of Food", "slug": "pot-of-food", "score": 4 }
  ]
}

Try it ↗

📅 Emoji of the Day

GET /api/eotd

Deterministic "emoji of the day". Changes daily, same for everyone worldwide.

https://emoji.findutils.com/api/eotd

Response

{
  "emoji": "\ud83d\ude80",
  "name": "Rocket",
  "slug": "rocket",
  "category": "Travel & Places",
  "date": "2026-04-03",
  "svg_url": "https://emoji.findutils.com/rocket",
  "badge_url": "https://emoji.findutils.com/badge/rocket?label=emoji+of+the+day&status=Rocket&color=blue"
}

Algorithm: Knuth multiplicative hash. Cache: 1 hour.

Try it ↗

📊 Stats API

GET /api/stats

Public usage statistics: top emojis, country flags, referrers, countries.

https://emoji.findutils.com/api/stats

Response

{
  "topEmojis": [{ "emoji": "\ud83d\udd25", "name": "Fire", "count": 1234 }],
  "countryEmojis": [...],
  "totalServed": 45678,
  "topReferrers": [{ "domain": "github.com", "count": 500 }],
  "topCountries": [{ "country": "US", "count": 300 }]
}

Cache: 1 minute.

Try it ↗

📈 Trending API

GET /api/trending

Top emojis ranked by recent usage. Includes sparkline SVG charts for each emoji's usage trend.

https://emoji.findutils.com/api/trending

Response

{
  "trending": [
    {
      "emoji": "\ud83d\udd25",
      "name": "Fire",
      "slug": "fire",
      "count": 1234,
      "sparkline": "https://emoji.findutils.com/api/trending/fire.svg"
    }
  ],
  "period": "24h"
}

Cache: 5 minutes.

Try it ↗

🔔 Webhooks API

POST /api/webhooks

Subscribe to emoji events: usage spikes, new trending emojis, milestone counts.

# Subscribe to events
curl -X POST https://emoji.findutils.com/api/webhooks \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/hook", "events": ["trending", "milestone"]}'

GET /api/webhooks

List active webhook subscriptions.

DELETE /api/webhooks/:id

Remove a webhook subscription.

Response

{
  "id": "wh_abc123",
  "url": "https://example.com/hook",
  "events": ["trending", "milestone"],
  "created_at": "2026-04-04T12:00:00Z"
}

📦 JavaScript SDK

Drop-in SDK for dynamic emoji favicons.

<script src="https://emoji.findutils.com/sdk.js"></script>

Usage:

// Simple
EmojiFavicon.set('fire');

// With options
EmojiFavicon.set('rocket', {
  size: 64,
  bg: '1a1a2e',
  darkbg: '0a0a0a',
  shape: 'circle',
  animate: 'pulse'
});

// Combo
EmojiFavicon.combo('fire', 'rocket');

// Emoji of the Day
EmojiFavicon.eotd();

// Search
const results = await EmojiFavicon.search('happy');

Methods:

Parameter	Type	Default	Description
`set(emoji, opts?)`	function	`-`	Set favicon to an emoji
`combo(e1, e2, opts?)`	function	`-`	Two emojis side by side
`eotd()`	function	`-`	Set to emoji of the day
`search(query)`	async	`-`	Search emojis, returns array
`suggest(text)`	async	`-`	Get emoji suggestions for text
`onBlur(emoji)`	function	`-`	Change favicon when tab loses focus
`onFocus(emoji)`	function	`-`	Change favicon when tab gains focus
`onVisibilityChange(visible, hidden)`	function	`-`	Toggle favicon on visibility change
`cycle(emojis, interval?)`	function	`-`	Cycle through emojis (default 2s interval)
`countdown(n, emoji?)`	function	`-`	Count down from n, updating favicon text
`status(state)`	function	`-`	Set favicon to a status icon (up/down/degraded)
`random(emojis)`	function	`-`	Set a random emoji from the list
`matchMedia(light, dark)`	function	`-`	Auto-switch emoji based on color scheme
`setBadge(n)`	function	`-`	Add notification badge to current favicon
`clearBadge()`	function	`-`	Remove notification badge
`destroy()`	function	`-`	Remove favicon and clean up listeners

Try it ↗

🤖 AI Plugin

Callable by ChatGPT, GPT Actions, MCP agents, Semantic Kernel, Copilot, and AI tools via standard manifests.

Skill Manifest /skill.json

AI Plugin /.well-known/ai-plugin.json

OpenAPI Spec /openapi.yaml

LLM Description /llms.txt

The /skill.json manifest describes 9 callable functions with full JSON Schema parameters, return types, and usage examples. Compatible with any AI agent framework.

📡 RSS/Atom Feed

GET /feed.xml

Atom feed of trending emojis. Top 20 most-used as feed entries.

https://emoji.findutils.com/feed.xml

Cache: 1 hour.

Try it ↗