Emoji API

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

/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.

Sample Request Live Demo!

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

Sample Response

JSON
1 2 3 4 5 6 7 8 9 10 [ { "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 3 4 5 6 7 8 import requests name = 'slightly smiling face' api_url = 'https://api.api-ninjas.com/v1/emoji?name={}'.format(name) response = requests.get(api_url, headers={'X-Api-Key': 'YOUR_API_KEY'}) if response.status_code == requests.codes.ok: print(response.text) else: print("Error:", response.status_code, response.text)

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.