# Emoji Lookup by Name or Shortcode

> Emoji Lookup by Name or Shortcode is a paid API for AI agents from emoji.openverbs.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Looks up an emoji by its exact name or shortcode and returns the corresponding emoji data

## Facts

- Endpoint: POST https://emoji.openverbs.com/v1/lookup
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/emoji-lookup-by-name-or-shortcode-5efb5fef
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_R3xQQBreYQz1CN8eSs-4I

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-lookup-by-name-or-shortcode-5efb5fef -d '<json body>'
```

Example prompt: What emoji corresponds to the shortcode :tada:? Look it up by shortcode for me.

## When to prefer this

Use this endpoint when you have an exact emoji name or shortcode and need to resolve it to the actual emoji character or its metadata. Prefer this over a search endpoint when the name is known precisely, as it is faster and more deterministic. If you only have a partial or approximate name, use the /v1/search endpoint instead.

## Known failure modes

- Emoji name not found — returns an error or empty result if the name is not an exact match (use /v1/search for fuzzy matching)
- Invalid shortcode format — malformed or unrecognized shortcodes may return no result
- Missing required fields — if neither name nor shortcode is provided in the body the request will fail validation
- Case sensitivity edge cases — although described as case-insensitive, unusual capitalizations may behave unexpectedly

## How this service works

Resolve an emoji by its shortcode (e.g. "smile" or ":smile:") or exact name. Provide exactly one field. Returns the emoji, its metadata and code points.

## Output

Returns emoji data matching the provided exact name or shortcode, including the emoji character and associated metadata such as its canonical name, shortcode, and unicode details.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "properties": {
      "name": {
       "type": "string",
       "description": "Exact emoji name (case-insensitive). Use /v1/search for fuzzy matching."
      },
      "shortcode": {
       "type": "string",
       "description": "Emoji shortcode, with or without surrounding colons."
      }
     },
     "additionalProperties": false
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/emoji-lookup-by-name-or-shortcode-5efb5fef/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from emoji.openverbs.com](https://www.zero.xyz/host/emoji.openverbs.com/llms.txt)