Random Emoji

Random Emoji Endpoint

The Random Emoji endpoint allows you to retrieve randomly selected emojis along with detailed information about them. You can customize the request to filter emojis by category, specify whether you want a symbol, and even retrieve multiple emojis in one request. This endpoint is perfect for adding fun and personality to your applications, such as in chat features, social media posts, or any interface that could benefit from a bit of randomness.

Endpoint

• URL: https://api.erensko.xyz/v1/random-emoji

• Method: GET

• Description: This endpoint provides randomly selected emoji(s) along with their details. You can customize the request by filtering emojis by category, symbol type, and the number of emojis returned.

URL Parameters

Key	Value
category (optional)	The category to filter emojis by. Use this to get emojis from a specific category (e.g., "Smileys & Emotion", "Animals & Nature").
isSymbol (optional)	Filters emojis to return only symbols (true) or only face/object emojis (false).
count (optional)	The number of emojis to return in a single request. The default is 1, and the maximum is 10. If you request more than 10, only 10 emojis will be returned.

Headers

Key	Value
Authorization	Your own personal API key, create one by clicking here. This is required.

Request Example

GET https://api.erensko.xyz/v1/random-emoji?category=Nature&isSymbol=true&count=3

Response Example

{
  "emoji1": {
    "emoji": "🍕",
    "emojiName": "Pizza",
    "unicode": "U+1F355",
    "category": "Food & Drink",
    "emojiMood": "Hungry",
    "emojiColor": "Yellow",
    "isSymbol": true,
    "emojiType": "Symbol"
  },
  "emoji2": {
    "emoji": "🍩",
    "emojiName": "Doughnut",
    "unicode": "U+1F369",
    "category": "Food & Drink",
    "emojiMood": "Sweet",
    "emojiColor": "Pink",
    "isSymbol": true,
    "emojiType": "Symbol"
  },
  "emoji3": {
    "emoji": "🍉",
    "emojiName": "Watermelon",
    "unicode": "U+1F349",
    "category": "Food & Drink",
    "emojiMood": "Refreshing",
    "emojiColor": "Green",
    "isSymbol": true,
    "emojiType": "Symbol"
  }
}

Usage Notes

• By default, the endpoint will return one random emoji per request.

• You can filter by category (e.g., "Smileys & Emotion", "Food & Drink") and symbol type (isSymbol=true for symbols, isSymbol=false for face/object emojis).

• Make sure to encode your parameters for options that have space between them like Food & Drink for example.