# Emoji Tools – Shortcode ↔ Emoji Converter

> Emoji Tools – Shortcode ↔ Emoji Converter is a paid API for AI agents from emoji-tools.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-02).

Converts a GitHub-style :shortcode: (or +1-style alias) to its emoji character, or an emoji character back to its shortcodes, using the github/gemoji table.

## Facts

- Endpoint: GET https://emoji-tools.x402tookit.com/emoji-shortcode?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/emoji-tools-shortcode-emoji-converter-91fee958
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Zv7eppL8GoaRc7GzGVB7Q

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability emoji-tools-shortcode-emoji-converter-91fee958
```

Example prompt: What emoji does :tada: map to, and what other shortcodes does it have?

## When to prefer this

Choose this endpoint when you need a fast, authoritative bidirectional mapping between GitHub-style emoji shortcodes and emoji characters, backed by the github/gemoji table. It is ideal for chat platforms, Markdown renderers, or developer tools that rely on GitHub's shortcode convention. Prefer it over generic Unicode lookup endpoints when shortcode compatibility with GitHub/Slack-style syntax is required.

## Known failure modes

- Unknown shortcode returns a response with null emoji and a status indicating no match
- Malformed or missing 'q' parameter returns an error or empty result
- Emoji character not in the gemoji table returns null shortcodes
- Typo in shortcode (missing colons, misspelling) results in no match

## How this service works

Convert a GitHub-style :shortcode: to its emoji or an emoji to its shortcodes, from the github/gemoji table.

## Output

Returns emoji metadata including the emoji character, its canonical name, all known shortcodes, Unicode codepoints, CLDR group and subgroup, emoji version, tags, and status. If the input is unrecognised, the response will include a null emoji and status/reason fields explaining the miss.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "A shortcode (:thumbsup:, +1) or an emoji (the character)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "name": {
       "type": [
        "null",
        "string"
       ]
      },
      "tags": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "emoji": {
       "type": [
        "null",
        "string"
       ]
      },
      "group": {
       "type": [
        "null",
        "string"
       ]
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "status": {
       "type": [
        "null",
        "string"
       ]
      },
      "reasons": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "summary": {
       "type": [
        "null",
        "string"
       ]
      },
      "verdict": {
       "type": [
        "null",
        "string"
       ]
      },
      "degraded": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "subgroup": {
       "type": [
        "null",
        "string"
       ]
      },
      "shortcode": {
       "type": [
        "null",
        "string"
       ]
      },
      "codepoints": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "disclaimer": {
       "type": [
        "null",
        "string"
       ]
      },
      "notChecked": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "shortcodes": {
       "type": [
        "ar
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/emoji-tools-shortcode-emoji-converter-91fee958/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from emoji-tools.x402tookit.com](https://www.zero.xyz/host/emoji-tools.x402tookit.com/llms.txt)