# Emoji Tools

Emoji search, info, skin tones, flags, text analysis and shortcodes from Unicode emoji data.

## How to pay

Machine-payable over x402. USDC on: Base (eip155:8453), Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), Polygon (eip155:137), Arbitrum One (eip155:42161).
No accounts. No API keys. No signup. The paying wallet is the account.

## Machine-readable

- OpenAPI: https://emoji-tools.x402tookit.com/openapi.json
- x402 manifest: https://emoji-tools.x402tookit.com/.well-known/x402
- Catalog (free): https://emoji-tools.x402tookit.com/catalog
- Health (free): https://emoji-tools.x402tookit.com/health
- Uptime (free): https://emoji-tools.x402tookit.com/uptime

## Endpoints (8)

### GET /emoji-analyze-text — $0.03
Analyze text (max 2000 chars): emoji count, distinct emoji, grapheme clusters, unqualified and text-presentation forms.
Params: text: string
Example: https://emoji-tools.x402tookit.com/emoji-analyze-text?text=Ship+it+%F0%9F%9A%80%F0%9F%9A%80+%E2%9D%A4+%F0%9F%91%8D%F0%9F%8F%BD+%F0%9F%87%BA%F0%9F%87%B8+1%EF%B8%8F%E2%83%A3

### GET /emoji-flag — $0.02
Convert a 2-letter country code to its flag emoji and back (regional indicators), plus England-style subdivision flags.
Params: q: string
Example: https://emoji-tools.x402tookit.com/emoji-flag?q=JP

### GET /emoji-group — $0.02
List the emoji in a Unicode group or subgroup (Animals & Nature, food-fruit) in CLDR order, or the group tree with counts.
Params: group: string, subgroup?: string, limit?: integer, offset?: integer
Example: https://emoji-tools.x402tookit.com/emoji-group?group=Food+%26+Drink&subgroup=food-fruit&limit=10

### GET /emoji-info — $0.02
Facts on one emoji: codepoints, CLDR name, group, Emoji version, qualification, ZWJ parts, skin tones, UTF-8/16 lengths.
Params: emoji: string
Example: https://emoji-tools.x402tookit.com/emoji-info?emoji=%F0%9F%91%8D%F0%9F%8F%BD

### GET /emoji-search — $0.02
Find emoji by keyword or name, ranked from CLDR names, keywords and shortcodes, with group filter, capped at 50.
Params: q: string, group?: string, limit?: integer
Example: https://emoji-tools.x402tookit.com/emoji-search?q=grinning+cat&limit=5

### GET /emoji-shortcode — $0.02
Convert a GitHub-style :shortcode: to its emoji or an emoji to its shortcodes, from the github/gemoji table.
Params: q: string
Example: https://emoji-tools.x402tookit.com/emoji-shortcode?q=%3Athumbsup%3A

### GET /emoji-skin-tones — $0.02
The five skin-tone variants (light to dark) of a base emoji with code points and names, or why it has none.
Params: emoji: string
Example: https://emoji-tools.x402tookit.com/emoji-skin-tones?emoji=%F0%9F%91%8B

### GET /emoji-version-support — $0.02
Which Emoji and Unicode version introduced an emoji (with release date), or what an Emoji version added. No vendor claims.
Params: q: string
Example: https://emoji-tools.x402tookit.com/emoji-version-support?q=melting+face

## Terms

Emoji data is from the Unicode Consortium emoji-test.txt (Unicode License v3), CLDR English annotations (Unicode License v3) and GitHub gemoji (MIT), provided as is. Names, groups and versions follow the data build date; how an emoji looks or whether a given device can show it is not stated by this data. Not affiliated with Unicode, Inc.