# Documentation - Emoji Favicon Service Documentation Getting Started [Quick Start](#quick-start) [URL Parameters](#url-params) Core Endpoints [Favicon](#favicon) [Combo Emoji](#combo) [Notification Badge](#notification-badge) [Text Favicon](#text-favicon) [Stacked Emoji](#stacked-emoji) [Branded Themes](#themes) [Conditional Favicons](#conditional) Extended Endpoints [Badge](#badge) [Avatar](#avatar) [README Banner](#readme-banner) [Status Icons](#status) [OG Image](#og-image) [Email Signature](#email-sig) [Embed / oEmbed](#embed) [Powered-By Badge](#powered-by) PWA & Mobile [Apple Touch Icon](#apple-touch-icon) [PWA Manifest](#pwa-manifest) [Download ZIP](#download) [Sprite Sheets](#sprite) Social & Engagement [Reactions](#reactions) [Link Preview](#link-preview) [A/B Testing](#ab-testing) APIs [Search](#search-api) [Suggest](#suggest-api) [Emoji of the Day](#eotd) [Stats](#stats-api) [Trending](#trending) [Webhooks](#webhooks) Integration [JavaScript SDK](#sdk) [AI Plugin](#ai-plugin) [RSS Feed](#feed) ## ⚡ Quick Start Add an emoji favicon to any website with a single HTML tag: ``` ``` 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 squarecircleroundedhexagondiamondshieldstarhearttrianglepentagonoctagondropeggcrosscloudbadge ### Animations Gallery pulsebouncespinshakefloatfliptadaswingwobbleheartbeatjellorubberbandflashpopsqueezenodglitchbreatherotate360wavezoomblinkslide-inrainbowtypingbounce-inattention **Example:** ``` https://emoji.findutils.com/fire?size=128&bg=1a1a2e&shape=hexagon&animate=tada ``` [Try it ↗](https://emoji.findutils.com/fire?size=128&bg=1a1a2e&shape=hexagon&animate=tada) ## 🌐 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 ↗](https://emoji.findutils.com/fire) ## 🔥 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 ↗](https://emoji.findutils.com/fire+rocket+star) ## 🔴 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 ↗](https://emoji.findutils.com/bell?badge=3) ## 🔤 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 ↗](https://emoji.findutils.com/text/AB) ## 📚 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 ↗](https://emoji.findutils.com/stack/globe+fire) ## 🎨 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 ↗](https://emoji.findutils.com/rocket?theme=github-dark) ## 🌙 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 ↗](https://emoji.findutils.com/sun?darkmode=moon) ## 🏷️ 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 ↗](https://emoji.findutils.com/badge/rocket?label=build&status=passing&color=green) ## 👤 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 | ```

``` **Cache:** CDN 30 days, browser 7 days (deterministic, never changes). [Try it ↗](https://emoji.findutils.com/avatar/user@example.com?shape=circle) ## 📖 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 ↗](https://emoji.findutils.com/readme/rocket?title=My+Awesome+Project&subtitle=Built+with+love) ## 🟢 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 ```

All systems operational https://emoji.findutils.com/status/up?emoji=rocket ``` **Cache:** 1 minute. [Try it ↗](https://emoji.findutils.com/status/up) ## 🖼️ OG Image GET `/:emoji?og=true` 1200x630 SVG images for social media sharing (Twitter, Facebook, LinkedIn). ``` ``` [Try it ↗](https://emoji.findutils.com/fire?og=true) ## ✉️ Email Signature GET `/sig/:emoji` PNG emoji for email signatures. Email clients can't render SVG, so this forces PNG via Twemoji. ```

``` **Cache:** 24 hours. [Try it ↗](https://emoji.findutils.com/sig/fire) ## 📦 Embed / oEmbed GET `/embed/:emoji` Minimal HTML page with centered emoji. For Notion embeds or iframes. ``` ``` 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. ```

``` [Try it ↗](https://emoji.findutils.com/badge/powered-by) ## 🍎 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. ``` ``` [Try it ↗](https://emoji.findutils.com/apple-touch-icon/rocket) ## 📋 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. ``` ``` 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 ↗](https://emoji.findutils.com/manifest/rocket) ## 📥 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 ↗](https://emoji.findutils.com/download/rocket) ## 📋 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 ↗](https://emoji.findutils.com/sprite?emojis=fire,rocket,star,heart,sparkles) ## 👍 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 ``` ``` Explicit Domain If Referer is not available (e.g. sandboxed iframes), pass the domain explicitly: ``` ``` 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 ↗](https://emoji.findutils.com/react/thumbsup) ## 🔗 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 ↗](https://emoji.findutils.com/preview/https://github.com) ## 🔀 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 ↗](https://emoji.findutils.com/ab/fire/rocket) ## 🔍 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 ↗](https://emoji.findutils.com/api/search?q=fire) ## 💡 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 ↗](https://emoji.findutils.com/api/suggest?text=coding+and+programming) ## 📅 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 ↗](https://emoji.findutils.com/api/eotd) ## 📊 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 ↗](https://emoji.findutils.com/api/stats) ## 📈 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 ↗](https://emoji.findutils.com/api/trending) ## 🔔 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. ``` ``` **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 ↗](https://emoji.findutils.com/sdk.js) ## 🤖 AI Plugin Callable by ChatGPT, GPT Actions, MCP agents, Semantic Kernel, Copilot, and AI tools via standard manifests. **Skill Manifest** `[/skill.json](https://emoji.findutils.com/skill.json)` **AI Plugin** `[/.well-known/ai-plugin.json](https://emoji.findutils.com/.well-known/ai-plugin.json)` **OpenAPI Spec** `[/openapi.yaml](https://emoji.findutils.com/openapi.yaml)` **LLM Description** `[/llms.txt](https://emoji.findutils.com/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 ↗](https://emoji.findutils.com/feed.xml) Share: [](https://x.com/intent/tweet?text=Check%20out%20emoji.findutils.com%20-%20Free%20emoji%20favicon%20service!%20One%20link%20tag%2C%20any%20emoji.%20&url=https://emoji.findutils.com) [](https://www.linkedin.com/sharing/share-offsite/?url=https://emoji.findutils.com) [](https://www.facebook.com/sharer/sharer.php?u=https://emoji.findutils.com) [](https://www.reddit.com/submit?url=https://emoji.findutils.com&title=Emoji+Favicon+Service+-+Any+emoji+as+your+site+favicon) [](https://www.tiktok.com/@findutils) --- *Source: [emoji.findutils.com](https://emoji.findutils.com)*