# EmojiFavicons — Free Emoji Favicon API > EmojiFavicons is a free URL-based favicon API that serves 3,773 emojis as SVG, PNG, or ICO. Add any emoji as your website favicon with one HTML line. No signup, no build step, no API key. ## About EmojiFavicons (emojifavicons.com) is a free emoji favicon API and generator. It converts emoji names into SVG, PNG, or ICO favicons via a simple URL pattern: https://emojifavicons.com/fire returns a fire emoji as an SVG favicon. The service supports 3,773 Unicode emojis searchable by 11,550 keywords, 16 shapes, 27 animations, 18 branded themes, gradient backgrounds, notification badges, combo emojis, pixel art, and a JavaScript SDK with 22+ methods. Each SVG response is under 200 bytes. Served from 300+ Cloudflare edge locations with a 7-day cache. Built by FindUtils (https://findutils.com), independent maker tools by @codewitholgun. ## Quick Start Add one line to your HTML : Replace "fire" with any emoji name: rocket, heart, star, globe, etc. ## Key Features - 3,773 emojis with 11,550 keyword lookups - SVG (default, <200 bytes), PNG (Twemoji), ICO formats - 16 shapes: circle, hexagon, shield, star, heart, diamond, and more - 27 animations: pulse, bounce, spin, shake, float, flip, and more - 18 branded themes: github-dark, vercel, tailwind, react, vue, etc. - Gradient backgrounds, custom colors, alignment options - Combo emojis (up to 10 side by side) - Pixel art mode with 16 color palettes - JavaScript SDK with 22+ methods - REST API with search, suggest, trending, and more - AI integrations: OpenAPI 3.1, ChatGPT plugin, skill.json ## Rate Limits 300 requests per minute per IP. No API key required. ## What it does Serves any emoji as SVG/PNG favicon, badge, avatar, README banner, status icon, OG image, or email signature. 3,773 emojis, 11,550 keywords, 50+ endpoints. Built on Cloudflare Workers (300+ edge locations). ## Endpoints ### Favicon GET /{emoji-name} - Returns SVG favicon (e.g. /fire, /rocket, /heart) GET /{emoji-name}?size=64&bg=1a1a1a&shape=circle&animate=pulse&align=center - With customization GET /{emoji1}+{emoji2}+...+{emojiN} - Combo 2-10 emojis side by side (e.g. /fire+rocket+star) GET /{emoji-name}?og=true - OG image for social sharing (1200x630) GET /{emoji-name}?png - Force PNG format (Twemoji) GET /{emoji-name}?svg - Force SVG format GET /{emoji-name}?badge=3 - Notification badge overlay (number 1-99 or "dot") GET /{emoji-name}?theme=github-dark - Apply branded theme preset GET /{emoji-name}?darkmode=moon - Conditional: show different emoji in dark mode GET /{emoji-name}?daytime=sun - Conditional: show different emoji during daytime GET /{emoji-name}?random=fire,rocket,star - Conditional: random emoji rotation Parameters: size (16-512), bg (hex), darkbg (hex), badge (number|dot), theme (18 presets), align (9 positions) Shapes (16): square|circle|rounded|hexagon|diamond|shield|star|heart|triangle|pentagon|octagon|drop|egg|cross|cloud|badge Animations (27): 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 Alignment (9): center|top-left|top|top-right|left|right|bottom-left|bottom|bottom-right Themes (18): github-dark|github-light|vercel-dark|stripe-blue|tailwind|react|vue|svelte|nextjs|nuxt|laravel|cloudflare|supabase|firebase|aws|dracula|nord|catppuccin ### Text Favicon GET /text/{chars} - 1-3 character text as favicon (initials, versions, labels) Parameters: bg (hex), color (hex, default fff), shape ### Stacked Emoji GET /stack/{bg}+{fg} - Layer one emoji on top of another ### Badge GET /badge/{emoji}?label=build&status=passing&color=green - Shields.io-style SVG badge GET /badge/powered-by - "Powered by emojifavicons.com" attribution pill Parameters: label, status, color (green|red|yellow|blue|hex), labelColor (hex), style (rounded|flat) ### Avatar GET /avatar/{identifier}?size=128&shape=circle - Deterministic emoji avatar (Gravatar-style) Parameters: size, shape (square|circle|rounded). Same input always = same avatar. ### README Banner GET /readme/{emoji}?title=My+Project&subtitle=Description&theme=dark - 800x200 SVG for GitHub READMEs Parameters: title, subtitle, theme (dark|light) ### Status Icons GET /status/up - Green circle (operational) GET /status/down - Red circle (outage) GET /status/degraded - Yellow circle (degraded) GET /status/maintenance - Wrench (maintenance) Parameters: emoji (override default), size ### OG Image GET /{emoji}?og=true - 1200x630 SVG for social media meta tags ### Email Signature GET /sig/{emoji} - PNG format for email clients that can't render SVG ### Embed GET /embed/{emoji} - Minimal HTML page for Notion/iframe embeds GET /oembed?url=https://emojifavicons.com/embed/fire - oEmbed discovery ### PWA & Mobile GET /apple-touch-icon/{emoji} - 180x180 iOS home screen icon GET /manifest/{emoji} - Auto-generated manifest.json with all icon sizes GET /download/{emoji} - ZIP package with all favicon sizes ### Sprite Sheets GET /sprite?emojis=fire,rocket,star - Multi-emoji grid SVG Parameters: emojis (comma-separated), size, cols ### Social & Engagement GET /react/{emoji} - Embeddable reaction widget with counter GET /preview/{url} - OG-image-style preview card with emoji GET /ab/{emojiA}/{emojiB} - A/B test: random variant serving with stats ### Search API GET /api/search?q={query} - Search emojis by name/keyword, returns up to 20 results (JSON) ### Suggest API GET /api/suggest?text={topic} - Suggest best emojis for a topic GET /api/suggest?url={url} - Analyze a URL and suggest emojis ### Emoji of the Day GET /api/eotd - Deterministic daily emoji, same worldwide (JSON) ### Stats API GET /api/stats - Public usage statistics: top emojis, referrers, countries (JSON) ### Trending API GET /api/trending - Top emojis with sparkline SVG charts (JSON) ### Webhooks API POST /api/webhooks - Subscribe to emoji events (trending, milestone) GET /api/webhooks - List active webhook subscriptions DELETE /api/webhooks/:id - Remove a webhook subscription ### All Emojis GET /api/emojis - Full catalog of all 3,773 emojis with categories (JSON) ### Gradient Backgrounds (v7) GET /{emoji}?gradient=sunset - Named presets: sunset, ocean, forest, aurora, candy, midnight, neon, lavender, fire, ice, rainbow, twilight GET /{emoji}?gradient=ff6b6b,feca57 - Custom two-color gradient Parameters: gradient-dir (degrees, default 135), gradient-type (linear|radial) ### Custom Cursors (v7) GET /cursor/{emoji} - CSS with data URI cursor GET /cursor/{emoji}?format=url - Just the data URI Parameters: size (default 32, max 128), hotspot (center|top-left|x,y) ### Countdown Favicon (v7) GET /countdown/{YYYY-MM-DD}?emoji=fire - Days remaining as badge GET /countup/{YYYY-MM-DD}?emoji=fire - Days elapsed as badge ### Favicon Health Checker (v7) GET /api/check?url=example.com - JSON report with score 0-100 GET /check/{domain} - HTML report card page ### Progress Bar Favicon (v7) GET /progress/{0-100}?emoji=rocket - Circular ring (default) or horizontal bar Parameters: style (ring|bar), color (hex), emoji, size ### ICO Format (v7) GET /{emoji}.ico - Multi-size ICO file (16+32+48 PNGs) GET /{emoji}?format=ico - Same as above ### Emoji Mashup (v7) GET /mashup/{emoji1}+{emoji2} - Visual blend of two emojis Parameters: mode (split|blend|diagonal|circle) ### Campaign Analytics (v7) GET /{emoji}?track=campaign-name - Track usage by campaign GET /api/analytics/campaign/{name} - Campaign stats JSON ### Color Palette (v7) GET /api/palette/{emoji} - Dominant colors (hex, RGB, HSL, Tailwind) GET /palette/{emoji} - Visual swatch page ### Accessibility API (v7) GET /api/a11y/{emoji} - ARIA labels, descriptions, colorblind info ### Emoji Version Diff (v7) GET /api/versions - List supported Unicode emoji versions GET /api/diff?from=15.0&to=15.1 - Emoji added between versions GET /diff/{from}/{to} - Visual comparison page ### QR Code with Emoji (v7.5) GET /qr/{emoji}?url=https://example.com - SVG QR code with emoji center Data types via ?type=: url (default), wifi, vcard, email, phone, sms, text, geo, event WiFi: ?type=wifi&ssid=Name&pass=secret&enc=WPA vCard: ?type=vcard&name=John Doe&phone=+123&email=a@b.com&org=Acme&title=Dev&website=https://... Style: size (128-512), fg (hex), qr-bg (hex), dot (square|rounded|dots|diamond|star), corner (square|rounded|dot), corner-color (hex), margin (0-4), grad-from (hex), grad-to (hex), grad-dir (vertical|horizontal|diagonal) ### Ref Tracking (v7.1) GET /{emoji}?ref=yourdomain.com - Opt-in attribution parameter, registers domain as verified user Combine with any other params: /fire?ref=mysite.com&size=64&bg=1a1a2e ### Showcase Directory (v7.1) GET /showcase - HTML page listing verified domains using the service GET /api/showcase - JSON directory of registered domains (limit, offset params) ### Domain Validation (v7.1) GET /api/validate-domain?domain=example.com - DNS-over-HTTPS domain validation ### Domain Registration (v7.1) POST /api/register-domain - Register domain in showcase (JSON body: domain, emoji). Rate limited 5/min. ### Pixel Emojis (v7.4) GET /pixel/{emoji}?palette=retro - Retro pixel art favicon with named color palette GET /pixel - Gallery page: browse all 168 hand-crafted pixel art icons GET /api/pixel-palettes - List all 16 palettes with colors and curated icon slugs Parameters: palette (16 named palettes), grid (8|12|16), gap (0-3), rounded (true|false), mirror (true|false), animate (pixel-cycle|pixel-wave|pixel-rain|pixel-glitch) Palettes: sunset, ocean, neon, cyber, fire, nature, mono, candy, gold, synth, retro, pastel, matrix, vapor, earth, arctic ### Favicon Presets (v7.4) GET /presets - HTML page with 44 ready-to-use favicon recipes across 8 categories GET /api/presets - List all preset categories GET /api/presets/{category} - Get presets for a category (saas|blog|docs|portfolio|ecommerce|gaming|devtool|startup) ### Emoji Meanings Dictionary (v7.6) GET /meanings - Browse 2,193 emoji meanings with definitions, uses, and shortcodes GET /meanings/{slug} - Individual emoji meaning page (e.g. /meanings/fire, /meanings/rocket) GET /api/meanings?q=fire&cat=Smileys+%26+Emotion&limit=50 - Search meanings API (JSON) ### Watermark Pattern (v7.4) GET /watermark/{emoji}?opacity=15&spacing=80&rotate=-30 - Tileable SVG pattern with repeating emoji Parameters: opacity (3-80), spacing (20-300), rotate (-90 to 90), font (8-96), size (100-2000), bg (hex) ### Bookmarklet (v7.4) GET /bookmarklet - HTML page with bookmarklet for previewing emoji favicons on any website GET /bookmarklet/{emoji} - Pre-configured bookmarklet for specific emoji ### CSS Variable (v7.4) GET /css/{emoji} - CSS text with --emoji-{name} custom property containing SVG data URI GET /api/css/{emoji} - JSON with CSS variable, data URI, and usage examples Use in background-image, list-style-image, ::before pseudo-elements, cursor ### Animated Sequence (v7.4) GET /sequence/{emoji1}+{emoji2}+...+{emojiN}?interval=1000 - Pure SVG frame cycling animation Parameters: interval (200-5000ms), size (16-512), bg (hex). Max 8 frames. No JS needed. ### Emoji Recolor (v7.4) GET /recolor/{emoji}?color=ff6b35 - Tint emoji with CSS filter from hex color GET /recolor/{emoji}?tint=grayscale - Named preset tint GET /api/recolor-presets - List all 10 named presets Presets: grayscale, sepia, invert, saturate, muted, warm, cool, neon, vintage, pastel ### JavaScript SDK GET /sdk.js - Client-side SDK with 22+ methods: set(), combo(), eotd(), search(), suggest(), onBlur(), onFocus(), cycle(), countdown(), countup(), progress(), cursor(), transition(), sequence(), stopTransition(), status(), random(), matchMedia(), setBadge(), clearBadge(), destroy() ### RSS Feed GET /feed.xml - Atom feed of trending emojis ### AI Integration GET /.well-known/ai-plugin.json - AI plugin manifest (ChatGPT, GPT Actions, MCP) GET /openapi.yaml - OpenAPI 3.1 specification GET /llms.txt - This file ## Pages - Homepage: https://emojifavicons.com/ - How to Add an Emoji Favicon (Guide): https://emojifavicons.com/guide - Emoji Favicon Generator: https://emojifavicons.com/generator - API Documentation: https://emojifavicons.com/docs - 71 Favicon Features: https://emojifavicons.com/features - Pixel Art Gallery (168 designs): https://emojifavicons.com/pixel - Branded Presets: https://emojifavicons.com/presets - Comparison vs favicon.io: https://emojifavicons.com/compare - Showcase (sites using EmojiFavicons): https://emojifavicons.com/showcase ## API Base URL All API endpoints are at https://emojifavicons.com/ (permanent, never changes). Marketing and documentation pages are at https://emojifavicons.com/. ## Machine-Readable - OpenAPI 3.1: https://emojifavicons.com/openapi.yaml - AI Plugin: https://emojifavicons.com/.well-known/ai-plugin.json - Atom Feed: https://emojifavicons.com/feed.xml - Full text: https://emojifavicons.com/llms-full.txt ## Contact contact@findutils.com https://x.com/codewitholgun