# emoji.findutils.com - Emoji Infrastructure Service

## 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, 35+ 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 - 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)
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
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 emoji.findutils.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://emoji.findutils.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)

### JavaScript SDK
GET /sdk.js - Client-side SDK with 15+ methods: set(), combo(), eotd(), search(), suggest(), onBlur(), onFocus(), cycle(), countdown(), 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

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

## Documentation
https://emoji.findutils.com/docs