RANDOM

Random Emoji API

GET/emoji

Get a random emoji from the bundled Unicode collection.

No signup or API key required.

Parameters

No endpoint-specific parameters. Use format to choose the response representation.

formatenumoptional · query: Response format. Defaults to json.
jsontext

No request body. Unknown or repeated query parameters return HTTP 400.

Returns 200 OK

A JSON object with the following fields.

emojistring: One emoji. May contain multiple Unicode code points, including joined sequences or flags.

Plain text

With format=text: Only the emoji value, without the JSON wrapper.

Errors

Validation and service errors always return JSON, including when format=text.

errorstring: A machine-readable error code, such as invalid_parameter or rate_limited.
messagestring: A description of the problem.

400 Invalid parameters.

414 Query string exceeds 2048 characters.

429 Rate limit reached. Wait the seconds in Retry-After before retrying.

Usage notes

All 1,923 fully qualified Unicode Emoji 18.0 entries without skin-tone modifiers, including flags and joined sequences. Bundled locally. Newer emoji may need an updated system font.

Give a demo avatar or status message a random emoji. Some results contain multiple Unicode code points, so do not assume one emoji has a string length of one.

Responses are not cached. Browser requests are supported through open CORS.

120 requests per minute per IP, with up to 30 per 10 seconds, shared across APIs. Limits are approximate per Cloudflare location. Full usage limits ↗