EmojiHub API

Free emoji API with no key: random or filtered emoji with names, categories, groups, HTML entity codes and Unicode code points. Tested curl example.

No API key requiredHTTPSFree tier

Endpoint tested and returned HTTP 200 on 20 Aug 2026

What is the EmojiHub API?

EmojiHub is a free, key-free API providing emoji data — name, category, group, HTML entity code and Unicode code point — with endpoints for random emoji or filtering by category and group.

EmojiHub returns emoji with both their HTML entity codes and Unicode code points, which covers both rendering paths: entity codes drop straight into HTML, while code points are what you need to build the character in JavaScript.

The category and group taxonomy is useful for building an emoji picker — categories are broad (`animals and nature`) while groups are narrower (`animal marine`), giving you two levels of navigation without inventing your own structure.

Quick facts

Base URL: https://emojihub.yurace.pro/api
Authentication: No API key required.
Rate limit: No published limit.
Pricing: Free and open source.
CORS: Not enabled — call it from your server
Official docs: Read the docs

How to use the EmojiHub API

Every request below was executed against the live API on 20 Aug 2026, and the response shown is the real body it returned — not an illustration.

1. Fetch a random emoji

GET https://emojihub.yurace.pro/api/random

curl

curl 'https://emojihub.yurace.pro/api/random'

JavaScript (fetch)

const res = await fetch("https://emojihub.yurace.pro/api/random");
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
console.log(data);

Python (requests)

import requests

res = requests.get("https://emojihub.yurace.pro/api/random", timeout=20)
res.raise_for_status()
print(res.json())

Response — HTTP 200

{
  "name": "squid",
  "category": "animals and nature",
  "group": "animal marine",
  "htmlCode": [
    "&#129425;"
  ],
  "unicode": [
    "U+1F991"
  ]
}

Parameters

Parameter	Type	Required	Description
`random`	path	Optional	A random emoji. `random`
`all`	path	Optional	Every emoji in the database. `all`
`all/category/<name>`	path	Optional	Filter by broad category. `category/animals-and-nature`
`random/group/<name>`	path	Optional	Random emoji from a specific group. `group/animal-marine`

Response fields

namestring: Emoji name, e.g. squid.
categorystring: Broad category such as `animals and nature`.
groupstring: Narrower group such as `animal marine`.
htmlCodearray: HTML entity codes — drop straight into markup.
unicodearray: Unicode code points such as U+1F991.

What you can build with the EmojiHub API

Build an emoji picker with category navigation
Add random emoji to a chat or social feature
Look up Unicode code points programmatically
Create emoji-based games or quizzes

Common errors and how to fix them

Category name not found

Names use hyphens in the URL.

Fix: Use animals-and-nature rather than the spaced form shown in the response.

Rendering the code point literally

unicode is a code point string, not the character.

Fix: Convert with String.fromCodePoint after stripping the U+ prefix, or use htmlCode in markup.

Multi-code-point emoji

Some emoji are sequences of several code points.

Fix: The unicode array can have several entries — combine them all, not just the first.

EmojiHub API — frequently asked questions

Is the EmojiHub API free?

Yes, completely free and open source with no API key.

How do I render the emoji?

Use htmlCode directly in HTML markup, or convert the unicode code points with String.fromCodePoint in JavaScript after removing the U+ prefix.

What is the difference between category and group?

Category is broad, such as `animals and nature`; group is narrower, such as `animal marine`. Together they give a two-level taxonomy for a picker.

Why do some emoji have several unicode values?

Emoji built from sequences — skin tone modifiers, combined characters — need multiple code points. Combine every entry in the array, not just the first.

Tools that pair with this API

Character Counter

Count characters with and without spaces in real time and check limits for Twitter/X, Instagram captions, meta descriptions and SMS messages.

JSON Formatter

Format, beautify and minify JSON online with 2-space, 4-space or tab indentation. Sort keys alphabetically and catch syntax errors instantly — free and private.

Alternatives to EmojiHub API

If EmojiHub does not fit, these text analysis apis cover similar ground. Every one was called before publishing, and each links to its own reference page with a working curl command and the response it returned.

API	What it does	Auth	CORS	Last verified
LanguageTool	Free grammar and spell checking API with no key: detect spelling, grammar and style errors in 25+ languages with suggested corrections. Tested GET and POST.	No key	Yes	19 Aug 2026
MyMemory Translation	Free translation API with no key: machine translation plus a human translation memory across 100+ language pairs. 5,000 words/day anonymously. Tested.	No key	Yes	19 Aug 2026
PurgoMalum	Free profanity filter API with no key: remove or mask offensive words from text, with custom word lists and configurable replacement characters. Tested.	No key	Yes	19 Aug 2026
LibreTranslate	Free open-source translation API: self-hostable machine translation across 30+ languages with no data sent to commercial providers. Tested curl example.	No key	Yes	20 Aug 2026
Jisho	Free Japanese dictionary API with no key: search in English, kanji, kana or romaji and get readings, glosses, parts of speech and JLPT tags. Tested example included.	No key	No	21 Aug 2026
KanjiAPI	Free kanji API with no key: readings, meanings, stroke count, JLPT level, school grade and Heisig keyword for any character. Tested example included.	No key	Yes	21 Aug 2026

All Text Analysis APIs

EmojiHub is an independent third-party service and is not affiliated with ByteTools or ByteVancer. Details on this page were verified on 20 Aug 2026; always check the official documentation before relying on this API in production, as terms and limits can change.