BYTETOOLS

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 2026-08-20

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 2026-08-20, 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": [
    "🦑"
  ],
  "unicode": [
    "U+1F991"
  ]
}

Parameters

ParameterTypeRequiredDescription
randompathOptionalA random emoji. random
allpathOptionalEvery emoji in the database. all
all/category/<name>pathOptionalFilter by broad category. category/animals-and-nature
random/group/<name>pathOptionalRandom 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.

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