NewConnect Claude, Gemini, ChatGPT, and other AI agents to API Ninjas via our MCP server →

Emoji API

The Emoji API provides image and metadata for all Unicode emojis. The data is updated periodically to fetch new emojis.

(4.4)

From 3,259 users

4,600+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
265ms295ms327ms591ms1124ms

Similar APIs

Didn't find what you were looking for? Suggest an improvement

/v1/emoji GET

https://api.api-ninjas.com/v1/emoji

Returns a list of emojis according to input parameters. Returns at most 30 results. To access more than 30 results, use the offset parameter to offset results in multiple API calls.

Parameters

At least one of the following parameters (other than offset) must be set:

  • name  optional

    Descriptive name of emoji.

  • code  optional

    Unicode character code for the emoji.

  • group  optional

    Main category the emoji belongs to. Possible values are:

    smileys_emotion
    people_body
    component
    animals_nature
    food_drink
    travel_places
    activities
    objects
    symbols
    flags
  • subgroup  optional

    Sub-category the emoji belongs to. Possible values are:

    Show subgroups.

  • offset  optional

    Number of results to offset for pagination.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

A JSON array of objects, each containing the following fields, or an error if the request is unsuccessful.

  • code

    Unicode character code for the emoji (e.g., "U+1F642").

  • character

    The emoji character itself.

  • image

    URL to an image of the emoji.

  • name

    Descriptive name of the emoji.

  • group

    Main category the emoji belongs to.

  • subgroup

    Sub-category the emoji belongs to.

Sample Request Live Demo!

name
code
group
subgroup
offset

Try our APIs in the API playground

Sign up for a free API key to get started — no credit card required.

https://api.api-ninjas.com/v1/emoji?name=slightly%20smiling%20face

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
[
    {
      code:"U+1F642",
      character:"🙂",
      image:"https://api-ninjas-data.s3.us-west-2.amazonaws.com/emojis/U%2B1F642.png",
      name:"slightly smiling face",
      group:"Smileys & Emotion",
      subgroup:"face-smiling"
    }
]

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/emoji?name=smile" \ -H "X-Api-Key: YOUR_API_KEY"

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.

Frequently Asked Questions

  • Yes, but you must have a premium subscription. Commercial use of the Emoji API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.
  • Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.
  • Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.
  • The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.
  • Set at least one of the name (descriptive name like slightly smiling face), code (Unicode character code such as U+1F642), group, or subgroup query parameters to filter the results. You can create a free account to get an API key and try the live demo on the docs page.
  • Each result is a JSON object with the code (Unicode character code), character (the emoji itself), image (a URL to a PNG image of the emoji), name, group, and subgroup fields. The image field is handy when you need rendered graphics rather than raw glyphs, similar to our Random Image API.
  • A single request returns at most 30 results, so combine a category filter like group (e.g. food_drink) or subgroup with the offset parameter to paginate through additional results across multiple calls. See the available request volume on our pricing page.
  • The API covers every Unicode emoji and the dataset is updated periodically to fetch newly released emojis. If you need image or metadata coverage for other assets, check out the Logo API or browse all our available APIs.