EmojiNet

A Machine Readable Sense Inventory for Emoji

Datasets | API | About Us

Here you will find the API documentation for the EmojiNet's RESTful API. The supported methods, the required parameters, sample request and response patterns along with examples are discussed below. The service endpoint is available at http://emojinet.knoesis.org/api. You can add the URL patterns provided in the method calls to the end of the above service endpoint URL to generate valid REST API requests. For example, to get the information about "Person Raising Both Hands in Celebration" emoji, you can add emoji/U0001F64C to the end of the above service URL to generate a working REST API service call that would look like this - http://emojinet.knoesis.org/api/emoji/U0001F64C. Please refer to the README file for more details. Please note that by using EmojiNet API you adhere to our LICENSE for EmojiNet. Please cite the following paper if you use EmojiNet REST API in your project.

Sanjaya Wijeratne, Lakshika Balasuriya, Amit Sheth, Derek Doran. EmojiNet: An Open Service and API for Emoji Sense Discovery. In 11th International AAAI Conference on Web and Social Media (ICWSM 2017). Montreal, Canada; 2017. [Kno.e.sis Library Page] | [PDF] | [BibTeX]

Get Emoji Information

Method Description This method returns information about a given emoji including its unicode, name, shortcode, description, keywords, category and related emoji.
URL /emoji/:emojiunicode
URL Params Required:
:emojiunicode=[unicodeString]
example: /emoji/U0001F64C
Success Response Content: [ { "category": "Emoticons -> Gesture symbols", "description": "Two hands raised in the air, celebrating success or another joyous event. Raising Hands was approved as part of Unicode 6.0 in 2010 under the name 'Person Raising Both Hands in Celebration' and added to Emoji 1.0 in 2015.", "keywords": [ "gesture", "hand", "celebration", "hooray", "raised" ], "related": [ "\\U0001F305", "\\U0001F37B", "\\U0001F389", "\\U0001F38A", "\\U0001F38F", "\\U0001F44D", "\\U0001F44F", "\\U0001F481_\\U0000200D_\\U00002642_\\U0000FE0F", "\\U0001F603", "\\U0001F64B_\\U0000200D_\\U00002640_\\U0000FE0F", "\\U0001F64B_\\U0000200D_\\U00002642_\\U0000FE0F", "\\U0001F64B_\\U0001F3FB_\\U0000200D_\\U00002640_\\U0000FE0F", "\\U0001F64B_\\U0001F3FB_\\U0000200D_\\U00002642_\\U0000FE0F", "\\U0001F64B_\\U0001F3FD_\\U0000200D_\\U00002640_\\U0000FE0F", "\\U0001F64B_\\U0001F3FD_\\U0000200D_\\U00002642_\\U0000FE0F", "\\U0001F64B_\\U0001F3FE_\\U0000200D_\\U00002640_\\U0000FE0F", "\\U0001F64B_\\U0001F3FE_\\U0000200D_\\U00002642_\\U0000FE0F", "\\U000026EA", "\\U0000270A", "\\U0001F1EE_\\U0001F1F9", "\\U0001F64F", "\\U0001F91A" ], "shortcode": ":raised_hands:", "title": "raising hands", "unicode": "U+1F64C" } ]
Error Response Content: "This emoji is not included in the demo REST API. Please check http://emojinet.org to find out emojis covered in this demo version of the API."
Sample Call http://emojinet.knoesis.org/api/emoji/U0001F64C

Get Emoji Images

Method Description This method returns information about vendor-specific images stored in EmojiNet for a given emoji. A binary representation of the image will be returned with the corresponder vendor name.
URL /emoji/images/:emojiunicode
URL Params Required:
:emojiunicode=[unicodeString]
example: /emoji/images/U0001F64C
Success Response Content: [ { "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEgAAABICAMAAABiM0N1AAAAS1BMVEVHcEz/3Fz/1Fb/3Fz/2Vv/1lj/1Fb/3Fz/1Vb/3Fz/qzL/0lL/01X/3Fz/zFD/rDL/rDP/rDL/3F3/3F3/rDP7zVbwmkb2sE76w1QZQSM4AAAAE3RSTlMAoy+C/AUe4UfC4xBr7VvKr5SVlHd/EwAAAsdJREFUWMPtlumSoyAQgLkEbzNBNO//pMuhCA0qyc5W7Y901WRKuvn6oDkQupW6bWv0gfDHg0QD7Ty31xZ5mfQ8Hg7MWsLvLiHnRZvNU3UBesCBExmN3c85qIf6U7EexzNQPcOIT8XUYJ5JHsSNMq7hxbqZqW2XA1WT+SruBlumRw70Yz768l6K7ANQ7KFAbAZt2pBTlHNRmYLZwRaZolUoEjJNdelofu3RrxgSIUVR6HeGjZSyQd2zwactx3HzrDbDbKQU613BtF6g56nV5ouiQf8yve8w7TL6HkkLEs4q3xjOxIH61GMn7dgBklUByHhncUj8Y5DkNyD0Nojgpn8bJEJQ32DdCpUZq/8GNJqRChHzgR2oegskNxA2vwTV/xmo/m0Q+Wcgt0U4pdseJ5TyAtAzDzKtwSyJMLvEWsLmL47IbEq91bVQaTf1pyDhp1O5b/R3QNth41TSpSad9R3I1ogJm4oYd1DjJiEfHN5AgzWRvR0kUUQWEYoGcbZP1mKtGXegw0r/jSEoFbbVRW7Xzyi3wrO8/SlIosqGvx+AnQUMFZLvgNS6rm7tjyPZFkwvoVapQtC6LMu6UiF9F/kGkIKuVl0AUtoscOlvQRIGvCzqDvRa1rCcw7Fbhyj35XUNeoGocXzzHYu6gpgAiMHs6QGisJLsArQuSerHcxY0WuwzBimYuezA1RdVIUyORPokIBEejgIoo5B4tBpJf+AQhJN+iz3iIG3YHdFDuE86jkUex6xG7rs9KBLUBn7r7WDeQVeZJbkFIHecHyGBEjHwSiQgpMN8zPRsvhuzPellPyK4yKuTt1aVdyl8t5Ehx8m8pLucyyGoACnjaFImpqiSCi4tPbv7KbBUKtIrpc4bCLzYWcxJQJ7FoBKIVjNPgbb7oJaXugdtVuYfeADZSJg3YFcg5jEuhQQU3WoXcmn7BX1BX1De9g9JlrlhjXePNAAAAABJRU5ErkJggg==", "vendor": "Twitter" } ]
Error Response Content: "This emoji is not included in the demo REST API. Please check http://emojinet.org to find out emojis covered in this demo version of the API."
Sample Call http://emojinet.knoesis.org/api/emoji/images/U0001F64C

Get Noun Meanings for Emoji

Method Description This method returns information about all noun meanings stored in EmojiNet for a given emoji. It will return null if there are no noun meanings available for the emoji.
URL /emoji/noun/:emojiunicode
URL Params Required:
:emojiunicode=[unicodeString]
example: /emoji/noun/U0001F64C
Success Response Content: [ { "babelnet_senseID": "bn:00042759n", "term": "hand" }, { "babelnet_senseID": "bn:00009676n", "term": "god" }, { "babelnet_senseID": "bn:00042759n", "term": "hands" }, { "babelnet_senseID": "bn:01193643n", "term": "praise" }, { "babelnet_senseID": "bn:00040336n", "term": "gesture" }, { "babelnet_senseID": "bn:00044716n", "term": "hooray" } ]
Error Response Content: "This emoji is not included in the demo REST API. Please check http://emojinet.org to find out emojis covered in this demo version of the API."
Sample Call http://emojinet.knoesis.org/api/emoji/noun/U0001F64C

Get Verb Meanings for Emoji

Method Description This method returns information about all verb meanings stored in EmojiNet for a given emoji. It will return null if there are no noun meanings available for the emoji.
URL /emoji/verb/:emojiunicode
URL Params Required:
:emojiunicode=[unicodeString]
example: /emoji/verb/U0001F64C
Success Response Content: { "data": [ { "babelnet_senseID": "bn:00091913v", "term": "praise" }, { "babelnet_senseID": "bn:13629680v", "term": "hooray" } ] }
Error Response Content: "This emoji is not included in the demo REST API. Please check http://emojinet.org to find out emojis covered in this demo version of the API."
Sample Call http://emojinet.knoesis.org/api/emoji/verb/U0001F64C

Get Adjectives Meanings for Emoji

Method Description This method returns information about all adjective meanings stored in EmojiNet for a given emoji. It will return null if there are no noun meanings available for the emoji.
URL /emoji/adjective/:emojiunicode
URL Params Required:
:emojiunicode=[unicodeString]
example: /emoji/adjective/U0001F602
Success Response Content: [ { "babelnet_senseID": "bn:00103933a", "term": "happy" }, { "babelnet_senseID": "bn:00100772a", "term": "cute" }, { "babelnet_senseID": "bn:00097006a", "term": "funny" }, { "babelnet_senseID": "bn:00105550a", "term": "joyful" }, { "babelnet_senseID": "bn:00104206a", "term": "hilarious" }, { "babelnet_senseID": "bn:00111681a", "term": "teary" }, { "babelnet_senseID": "bn:00105777a", "term": "laughing" } ]
Error Response Content: "This emoji is not included in the demo REST API. Please check http://emojinet.org to find out emojis covered in this demo version of the API."
Sample Call http://emojinet.knoesis.org/api/emoji/adjective/U0001F602

Get Twitter Word Embeddings for Emoji

Method Description This method returns Twitter-based context words learned for a given emoji sense. The method expects a BabelNet sense ID as the input and return a list of words learned by our Twitter-based word embedding model for the given sense definition.
URL /sensevec/twitter/:babelnetsenseID
URL Params Required:
:babelnetsenseID=[babelnetsenseIDString]
example: /sensevec/twitter/bn:00104206a
Success Response Content: { "twittervec": "funni,funny,hilari,cool/funni,hilarious,cool,halari,bomedi,joke,fuunnyy,allahusnackb,akekek,weird,funnyy,fuuni,funnyashel,hilar,lmao,funnt,anderia,assel ;,spnaturalsourc,janblu,fenday,nev-,ex'act,wooden-swings-and-diet-cok,globarbi,-*,shreddedwristsandbrokenheart,raisedbydrak,hard-on-for-hiddleston,kansastexa,jensackl,ifyousayso,ifeellessalien,bonus-,teddyowl-bb,],jay-z-01-htotheizzo(promo,almightysharri caus,cuz,cu,bc,bevaus,melquan,yainaa,kiylah,xaquariu,asfck,mufukka,growingupanathlet,nobdoy,dai'jah,shamyiah,ashame,cays,gonma,korsha,tquan,chatara great,awesom,amaz,fantast,good,gr8,nice,great,fabul,fab,greaat,excel,faboo,brilliant,specialff,great-,greatt,grear,greay,f-abba-l,foxtast merriment,#cabernetday,poetsday,stone20,fremontchicago,afterworkdrink,#nationalwhiskeysourday,fizzfriday,cabernetday,nationalwhiskeysourday,nationalpinotnoirday,dankellyscid,nationalwineday,theperfectbirthdayparti,theblackcat,#ginandton,exploresf,turning30,belindacarlisl,ginfestiv,rhymecrim laughter,laugh,giggl,#laughter,laughter,uproari,minguk',uncri,msdhonitrailerlaunch,iwanttothanknhcfor,olderthanireland,@broadwayjanitor',whyjoeisouridol,cackl,laugh,markistakingov,joy,uncontrollably,aldubyoualw,laughs,hyster,mark,yi-en,holyfuckmark,zuckerburg,tuan',walberg,marksondaili,tuanpumpkin,marksjourney,zukerberg,yien,marktuan,markticsea,dailyrothko,rylanc,pastel-mark,bobbythepineapplelomax,tuan,gatiss,watney,summertuan caus,cuz,cu,bc,bevaus,melquan,yainaa,kiylah,xaquariu,asfck,mufukka,growingupanathlet,nobdoy,dai'jah,shamyiah,ashame,cays,gonma,korsha,tquan,chatara boister,pupster,rivalry,rapists,well-adjust,harrumph,dehumanis,geriatr,next-door,undisciplin,narcisst,heynext,charolai,#pawfect,crotcheti,unsympathet,rambuncti,well-behav,n+1,whove,fleas merriment,#cabernetday,poetsday,stone20,fremontchicago,afterworkdrink,#nationalwhiskeysourday,fizzfriday,cabernetday,nationalwhiskeysourday,nationalpinotnoirday,dankellyscid,nationalwineday,theperfectbirthdayparti,theblackcat,#ginandton,exploresf,turning30,belindacarlisl,ginfestiv,rhymecrim convuls,diverticul,repug,mucou,#hillaryisunfit,unpleasant,hackinghillari,writeoff,vulgar,hyperemesi,unfit,obamao,deplorables,upchuck,uncontrollably,infections,otiti,migraines,hillaryhack,pleurisi,repubhumor laughter,laugh,giggl,#laughter,laughter,uproari,minguk',uncri,msdhonitrailerlaunch,iwanttothanknhcfor,olderthanireland,@broadwayjanitor',whyjoeisouridol,cackl,laugh,markistakingov,joy,uncontrollably,aldubyoualw,laughs,hyster" }
Error Response Content: "This emoji is not included in the demo REST API. Please check http://emojinet.org to find out emojis covered in this demo version of the API."
Sample Call http://emojinet.knoesis.org/api/sensevec/twitter/bn:00104206a

Get Google News Word Embeddings for Emoji

Method Description This method returns Google News-based context words learned for a given emoji sense. The method expects a BabelNet sense ID as the input and return a list of words learned by our Google News-based word embedding model for the given sense definition.
URL /sensevec/google/:babelnetsenseID
URL Params Required:
:babelnetsenseID=[babelnetsenseIDString]
example: sensevec/google/bn:00104206a
Success Response Content: { "googlevec": "caus,sumthing,lyk,eof,u've,ect,yt,esp,4get,u're,some1,Jackass_sey,dont,ect_ect,bla,ra,u_mhux,eto,u_hv,sist,cks great,terrific,fantastic,tremendous,wonderful,good,incredible,marvelous,phenomenal,amazing,awesome,unbelievable,nice,fabulous,excellent,agreat,huge,immense,greatest,really,superb merriment,mirth,revelry,merrymaking,jollity,gaiety,frivolity,festivity,hilarity,revelries,joviality,jollification,joyousness,tomfoolery,jolliness,high_jinks,silliness,belly_laughs,debauchery,cheeriness,Yuletide laughter,giggles,uproarious_laughter,guffaws,chuckles,raucous_laughter,mirth,Laughter,hearty_laughter,belly_laughs,hysterical_laughter,laughs,guffaw,Naresh_Chand_bursting,uncontrollable_laughter,applause,titters,laugh,derisive_laughter,cheers,giggle,mark,marks,marking,record,marked,eclipsing,emerald_hued_holiday,countryman_Haile_Gebrselassie,milestone,plateau,##-#.#_#.##m,##-##.##_ft.,Max_Knake,surpassing,surpass,leveraged_buyout_dwarfing,Younis_Khalis_former,eclipsed,Bulgaria_Stefka_Kostadinova,bettered,commemorate caus,sumthing,lyk,eof,u've,ect,yt,esp,4get,u're,some1,Jackass_sey,dont,ect_ect,bla,ra,u_mhux,eto,u_hv,sist,cks merriment,mirth,revelry,merrymaking,jollity,gaiety,frivolity,festivity,hilarity,revelries,joviality,jollification,joyousness,tomfoolery,jolliness,high_jinks,silliness,belly_laughs,debauchery,cheeriness,Yuletide laughter,giggles,uproarious_laughter,guffaws,chuckles,raucous_laughter,mirth,Laughter,hearty_laughter,belly_laughs,hysterical_laughter,laughs,guffaw,Naresh_Chand_bursting,uncontrollable_laughter,applause,titters,laugh,derisive_laughter,cheers,giggle" }
Error Response Content: "This emoji is not included in the demo REST API. Please check http://emojinet.org to find out emojis covered in this demo version of the API."
Sample Call http://emojinet.knoesis.org/api/sensevec/google/bn:00104206a