# Emoji Tools – List Emoji by Group/Subgroup

> Emoji Tools – List Emoji by Group/Subgroup 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).

Lists emoji within a Unicode group or subgroup in CLDR order, or returns the full group/subgroup tree with counts.

## Facts

- Endpoint: GET https://emoji-tools.x402tookit.com/emoji-group?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-list-emoji-by-group-subgroup-fa9dd1f5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NFRskipLPUnjxL_McdOrh

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-list-emoji-by-group-subgroup-fa9dd1f5
```

Example prompt: Can you list all the emoji in the 'Animals & Nature' Unicode group in CLDR order? Show me the first 50, including their names, subgroups, and codepoints.

## When to prefer this

Use this endpoint when you need to enumerate or browse emoji within a specific Unicode category in standard CLDR order, or when you need a structured overview of the full emoji group/subgroup hierarchy with counts. It is ideal for building emoji pickers, populating category-based UI, or discovering what emoji exist within a domain like food, animals, or travel. Prefer it over a keyword search endpoint when you want exhaustive category coverage rather than relevance-ranked results.

## Known failure modes

- Invalid or misspelled group name returns empty results or an error
- Subgroup not belonging to specified group returns no results
- Offset beyond total count returns empty results array
- Limit outside 1–200 range may be rejected or clamped
- Missing required 'group' query parameter returns a validation error

## How this service works

List the emoji in a Unicode group or subgroup (Animals & Nature, food-fruit) in CLDR order, or the group tree with counts.

## Output

Returns a paginated list of emoji objects each containing the emoji character, CLDR name, Unicode group, subgroup, codepoints array, emoji version, and qualification status. Also includes total count, offset, and source attribution. When group='list', returns the full group/subgroup tree with counts instead.

## 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": [
      "group"
     ],
     "properties": {
      "group": {
       "type": "string",
       "description": "Group name (Food & Drink), or 'list' for all groups and subgroups with counts"
      },
      "limit": {
       "type": "integer",
       "description": "Results 1 to 200 (default 100)"
      },
      "offset": {
       "type": "integer",
       "description": "Skip this many results (default 0)"
      },
      "subgroup": {
       "type": "string",
       "description": "Optional subgroup such as food-fruit or animal-mammal"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "group": {
       "type": [
        "null",
        "string"
       ]
      },
      "total": {
       "type": [
        "null",
        "number"
       ]
      },
      "offset": {
       "type": [
        "null",
        "number"
       ]
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "reasons": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "results": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "object",
        "properties": {
         "name": {
          "type": [
           "null",
           "string"
          ]
         },
         "emoji": {
          "type": [
           "null",
           "string"
          ]
         },
         "group": {
          "type": [
           "null",
           "string"
          ]
         },
         "status": {
          "type": [
           "null",
           "string"
          ]
         },
         "subgroup": {
          "type": [
           "null",
           "string"
          ]
         },
         "codepoints": {
          "type
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/emoji-tools-list-emoji-by-group-subgroup-fa9dd1f5/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)