# Emoji Get Search

> Search for emojis whose name or category contains the given query string (case-insensitive). Returns a list of all matches.

- Skill: `gabrielmoreira/emoji-get-search` (Agent Skill)
- Install (CLI): `npx skillmds@latest add gabrielmoreira/emoji-get-search`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gabrielmoreira/emoji-get-search/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: gabrielmoreira (https://skillmd.com/u/gabrielmoreira)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/gabrielmoreira/emoji-get-search

---


## Endpoint

**GET https://requiems.xyz/v1/entertainment/emoji/search**

## Search Emoji

Search for emojis whose name or category contains the given query string (case-insensitive). Returns a list of all matches.

## Parameters

| Name | Type | Required | Location | Description |
| ---- | ---- | -------- | -------- | ----------- |
| `q` | string | yes | query | Search term to match against emoji names and categories (e.g. happy, heart, food) |

## Response Example

```json
{
  "data": {
    "items": [
      {
        "emoji": "😄",
        "name": "grinning_face_with_smiling_eyes",
        "category": "Smileys & Emotion",
        "unicode": "U+1F604"
      }
    ],
    "total": 1
  },
  "metadata": {
    "timestamp": "2026-01-01T00:00:00Z"
  }
}
```

## Response Fields

| Field | Type | Description |
| ----- | ---- | ----------- |
| `items` | array<object> | List of matching emoji objects |
| `total` | integer | Total number of matches |

## Errors

- `400` **bad_request** — The q query parameter is missing or empty.