{"openapi":"3.1.0","info":{"title":"Emoji API","version":"1.0.0","description":"A complete emoji database in one fast API. Search roughly 1,870 emojis by name, keyword, alias or tag, look up a single emoji by its alias (like rocket or :fire:) or by the emoji character itself, browse any of the nine Unicode categories, or get random emojis (optionally from a category). Every emoji comes with its name, category, aliases, search tags, Unicode code points and the version it was introduced in. Built on the open GitHub gemoji dataset and served entirely in-memory, so responses are instant and the service is always available. Ideal for chat and messaging apps, emoji pickers and search, social and content tools, games and fun widgets.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/emoji-api","description":"oanor gateway"}],"tags":[{"name":"Emoji"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/category":{"get":{"operationId":"get_v1_category","tags":["Emoji"],"summary":"Emojis by category (or list categories)","description":"","parameters":[{"name":"name","in":"query","required":false,"description":"Category name (omit to list all with counts)","schema":{"type":"string"},"example":"Food & Drink"},{"name":"limit","in":"query","required":false,"description":"1-1000 (default 100)","schema":{"type":"string"},"example":"100"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":100,"emojis":[{"name":"grapes","tags":[],"emoji":"🍇","aliases":["grapes"],"category":"Food & Drink","codepoints":"U+1F347","unicode_version":"6.0"},{"name":"melon","tags":[],"emoji":"🍈","aliases":["melon"],"category":"Food & Drink","codepoints":"U+1F348","unicode_version":"6.0"},{"name":"watermelon","tags":[],"emoji":"🍉","aliases":["watermelon"],"category":"Food & Drink","codepoints":"U+1F349","unicode_version":"6.0"},{"name":"tangerine","tags":[],"emoji":"🍊","aliases":["tangerine","orange","mandarin"],"category":"Food & Drink","codepoints":"U+1F34A","unicode_version":"6.0"},{"name":"lemon","tags":[],"emoji":"🍋","aliases":["lemon"],"category":"Food & Drink","codepoints":"U+1F34B","unicode_version":"6.0"},{"name":"banana","tags":["fruit"],"emoji":"🍌","aliases":["banana"],"category":"Food & Drink","codepoints":"U+1F34C","unicode_version":"6.0"},{"name":"pineapple","tags":[],"emoji":"🍍","aliases":["pineapple"],"category":"Food & Drink","codepoints":"U+1F34D","unicode_version":"6.0"},{"name":"mango","tags":[],"emoji":"🥭","aliases":["mango"],"category":"Food & Drink","codepoints":"U+1F96D","unicode_version":"11.0"},{"name":"red apple","tags":[],"emoji":"🍎","aliases":["apple"],"category":"Food & Drink","codepoints":"U+1F34E","unicode_version":"6.0"},{"name":"green apple","tags":["fruit"],"emoji":"🍏","aliases":["green_apple"],"category":"Food & Drink","codepoints":"U+1F34F","unicode_version":"6.0"},{"name":"pear","tags":[],"emoji":"🍐","aliases":["pear"],"category":"Food & Drink","codepoints":"U+1F350","unicode_version":"6.0"},{"name":"peach","tags":[],"emoji":"🍑","aliases":["peach"],"category":"Food & Drink","codepoints":"U+1F351","unicode_version":"6.0"},{"name":"cherries","tags":["fruit"],"emoji":"🍒","aliases":["cherries"],"category":"Food & Drink","codepoints":"U+1F352","unicode_version":"6.0"},{"name":"strawberry","tags":["fruit"],"emoji":"🍓","aliases":["strawberry"],"category":"Food & Drink","codepoints":"U+1F353","unicode_version":"6.0"},{"name":"blueberries","tags":[],"emoji":"🫐","aliases":["blueberries"],"category":"Food & Drink","codepoints":"U+1FAD0","unicode_version":"13.0"},{"name":"kiwi fruit","tags":[],"emoji":"🥝","aliases":["kiwi_fruit"],"category":"Food & Drink","codepoints":"U+1F95D","unicode_version":"9.0"},{"name":"tomato","tags":[],"emoji":"🍅","aliases":["tomato"],"category":"Food & Drink","codepoints":"U+1F345","unicode_version":"6.0"},{"name":"olive","tags":[],"emoji":"🫒","aliases":["olive"],"category":"Food & Drink","codepoints":"U+1FAD2","unicode_version":"13.0"},{"name":"coconut","tags":[],"emoji":"🥥","aliases":["coconut"],"category":"Food & Drink","codepoints":"U+1F965","unicode_version":"11.0"},{"name":"avocado","tags":[],"emoji":"🥑","aliases":["avocado"],"category":"Food & Drink","codepoints":"U+1F951","unicode_version":"9.0"},{"name":"eggplant","tags":["aubergine"],"emoji":"🍆","aliases":["eggplant"],"category":"Food & Drink","codepoints":"U+1F346","unicode_version":"6.0"},{"name":"potato","tags":[],"emoji":"🥔","aliases":["potato"],"category":"Food & Drink","codepoints":"U+1F954","unicode_version":"9.0"},{"name":"carrot","tags":[],"emoji":"🥕","aliases":["carrot"],"category":"Food & Drink","codepoints":"U+1F955","unicode_version":"9.0"},{"name":"ear of corn","tags":[],"emoji":"🌽","aliases":["corn"],"category":"Food & Drink","codepoints":"U+1F33D","unicode_version":"6.0"},{"name":"hot pepper","tags":["spicy"],"emoji":"🌶️","aliases":["hot_pepper"],"category":"Food & Drink","codepoints":"U+1F336 U+FE0F","unicode_version":"7.0"},{"name":"bell pepper","tags":[],"emoji":"🫑","aliases":["bell_pepper"],"category":"Food & Drink","codepoints":"U+1FAD1","unicode_version":"13.0"},{"name":"cucumber","tags":[],"emoji":"🥒","aliases":["cucumber"],"category":"Food & Drink","codepoints":"U+1F952","unicode_version":"9.0"},{"name":"leafy green","tags":[],"emoji":"🥬","aliases":["leafy_green"],"category":"Food & Drink","codepoints":"U+1F96C","unicode_version":"11.0"},{"name":"broccoli","tags":[],"emoji":"🥦","aliases":["broccoli"],"category":"Food & Drink","codepoints":"U+1F966","unicode_version":"11.0"},{"name":"garlic","tags":[],"emoji":"🧄","aliases":["garlic"],"category":"Food & Drink","codepoints":"U+1F9C4","unicode_version":"12.0"},{"name":"onion","tags":[],"emoji":"🧅","aliases":["onion"],"category":"Food & Drink","codepoints":"U+1F9C5","unicode_version":"12.0"},{"name":"peanuts","tags":[],"emoji":"🥜","aliases":["peanuts"],"category":"Food & Drink","codepoints":"U+1F95C","unicode_version":"9.0"},{"name":"beans","tags":[],"emoji":"🫘","aliases":["beans"],"category":"Food & Drink","codepoints":"U+1FAD8","unicode_version":"14.0"},{"name":"chestnut","tags":[],"emoji":"🌰","aliases":["chestnut"],"category":"Food & Drink","codepoints":"U+1F330","unicode_version":"6.0"},{"name":"ginger root","tags":[],"emoji":"🫚","aliases":["ginger_root"],"category":"Food & Drink","codepoints":"U+1FADA","unicode_version":"15.0"},{"name":"pea pod","tags":[],"emoji":"🫛","aliases":["pea_pod"],"category":"Food & Drink","codepoints":"U+1FADB","unicode_version":"15.0"},{"name":"bread","tags":["toast"],"emoji":"🍞","aliases":["bread"],"category":"Food & Drink","codepoints":"U+1F35E","unicode_version":"6.0"},{"name":"croissant","tags":[],"emoji":"🥐","aliases":["croissant"],"category":"Food & Drink","codepoints":"U+1F950","unicode_version":"9.0"},{"name":"baguette bread","tags":[],"emoji":"🥖","aliases":["baguette_bread"],"category":"Food & Drink","codepoints":"U+1F956","unicode_version":"9.0"},{"name":"flatbread","tags":[],"emoji":"🫓","aliases":["flatbread"],"category":"Food & Drink","codepoints":"U+1FAD3","unicode_version":"13.0"},{"name":"pretzel","tags":[],"emoji":"🥨","aliases":["pretzel"],"category":"Food & Drink","codepoints":"U+1F968","unicode_version":"11.0"},{"name":"bagel","tags":[],"emoji":"🥯","aliases":["bagel"],"category":"Food & Drink","codepoints":"U+1F96F","unicode_version":"11.0"},{"name":"pancakes","tags":[],"emoji":"🥞","aliases":["pancakes"],"category":"Food & Drink","codepoints":"U+1F95E","unicode_version":"9.0"},{"name":"waffle","tags":[],"emoji":"🧇","aliases":["waffle"],"category":"Food & Drink","codepoints":"U+1F9C7","unicode_version":"12.0"},{"name":"cheese wedge","tags":[],"emoji":"🧀","aliases":["cheese"],"category":"Food & Drink","codepoints":"U+1F9C0","unicode_version":"8.0"},{"name":"meat on bone","tags":[],"emoji":"🍖","aliases":["meat_on_bone"],"category":"Food & Drink","codepoints":"U+1F356","unicode_version":"6.0"},{"name":"poultry leg","tags":["meat","chicken"],"emoji":"🍗","aliases":["poultry_leg"],"category":"Food & Drink","codepoints":"U+1F357","unicode_version":"6.0"},{"name":"cut of meat","tags":[],"emoji":"🥩","aliases":["cut_of_meat"],"category":"Food & Drink","codepoints":"U+1F969","unicode_version":"11.0"},{"name":"bacon","tags":[],"emoji":"🥓","aliases":["bacon"],"category":"Food & Drink","codepoints":"U+1F953","unicode_version":"9.0"},{"name":"hamburger","tags":["burger"],"emoji":"🍔","aliases":["hamburger"],"category":"Food & Drink","codepoints":"U+1F354","unicode_version":"6.0"},{"name":"french fries","tags":[],"emoji":"🍟","aliases":["fries"],"category":"Food & Drink","codepoints":"U+1F35F","unicode_version":"6.0"},{"name":"pizza","tags":[],"emoji":"🍕","aliases":["pizza"],"category":"Food & Drink","codepoints":"U+1F355","unicode_version":"6.0"},{"name":"hot dog","tags":[],"emoji":"🌭","aliases":["hotdog"],"category":"Food & Drink","codepoints":"U+1F32D","unicode_version":"8.0"},{"name":"sandwich","tags":[],"emoji":"🥪","aliases":["sandwich"],"category":"Food & Drink","codepoints":"U+1F96A","unicode_version":"11.0"},{"name":"taco","tags":[],"emoji":"🌮","aliases":["taco"],"category":"Food & Drink","codepoints":"U+1F32E","unicode_version":"8.0"},{"name":"burrito","tags":[],"emoji":"🌯","aliases":["burrito"],"category":"Food & Drink","codepoints":"U+1F32F","unicode_version":"8.0"},{"name":"tamale","tags":[],"emoji":"🫔","aliases":["tamale"],"category":"Food & Drink","codepoints":"U+1FAD4","unicode_version":"13.0"},{"name":"stuffed flatbread","tags":[],"emoji":"🥙","aliases":["stuffed_flatbread"],"category":"Food & Drink","codepoints":"U+1F959","unicode_version":"9.0"},{"name":"falafel","tags":[],"emoji":"🧆","aliases":["falafel"],"category":"Food & Drink","codepoints":"U+1F9C6","unicode_version":"12.0"},{"name":"egg","tags":[],"emoji":"🥚","aliases":["egg"],"category":"Food & Drink","codepoints":"U+1F95A","unicode_version":"9.0"},{"name":"cooking","tags":["breakfast"],"emoji":"🍳","aliases":["fried_egg"],"category":"Food & Drink","codepoints":"U+1F373","unicode_version":"6.0"},{"name":"shallow pan of food","tags":["paella","curry"],"emoji":"🥘","aliases":["shallow_pan_of_food"],"category":"Food & Drink","codepoints":"U+1F958","unicode_version":""},{"name":"pot of food","tags":[],"emoji":"🍲","aliases":["stew"],"category":"Food & Drink","codepoints":"U+1F372","unicode_version":"6.0"},{"name":"fondue","tags":[],"emoji":"🫕","aliases":["fondue"],"category":"Food & Drink","codepoints":"U+1FAD5","unicode_version":"13.0"},{"name":"bowl with spoon","tags":[],"emoji":"🥣","aliases":["bowl_with_spoon"],"category":"Food & Drink","codepoints":"U+1F963","unicode_version":"11.0"},{"name":"green salad","tags":[],"emoji":"🥗","aliases":["green_salad"],"category":"Food & Drink","codepoints":"U+1F957","unicode_version":"9.0"},{"name":"popcorn","tags":[],"emoji":"🍿","aliases":["popcorn"],"category":"Food & Drink","codepoints":"U+1F37F","unicode_version":"8.0"},{"name":"butter","tags":[],"emoji":"🧈","aliases":["butter"],"category":"Food & Drink","codepoints":"U+1F9C8","unicode_version":"12.0"},{"name":"salt","tags":[],"emoji":"🧂","aliases":["salt"],"category":"Food & Drink","codepoints":"U+1F9C2","unicode_version":"11.0"},{"name":"canned food","tags":[],"emoji":"🥫","aliases":["canned_food"],"category":"Food & Drink","codepoints":"U+1F96B","unicode_version":"11.0"},{"name":"bento box","tags":[],"emoji":"🍱","aliases":["bento"],"category":"Food & Drink","codepoints":"U+1F371","unicode_version":"6.0"},{"name":"rice cracker","tags":[],"emoji":"🍘","aliases":["rice_cracker"],"category":"Food & Drink","codepoints":"U+1F358","unicode_version":"6.0"},{"name":"rice ball","tags":[],"emoji":"🍙","aliases":["rice_ball"],"category":"Food & Drink","codepoints":"U+1F359","unicode_version":"6.0"},{"name":"cooked rice","tags":[],"emoji":"🍚","aliases":["rice"],"category":"Food & Drink","codepoints":"U+1F35A","unicode_version":"6.0"},{"name":"curry rice","tags":[],"emoji":"🍛","aliases":["curry"],"category":"Food & Drink","codepoints":"U+1F35B","unicode_version":"6.0"},{"name":"steaming bowl","tags":["noodle"],"emoji":"🍜","aliases":["ramen"],"category":"Food & Drink","codepoints":"U+1F35C","unicode_version":"6.0"},{"name":"spaghetti","tags":["pasta"],"emoji":"🍝","aliases":["spaghetti"],"category":"Food & Drink","codepoints":"U+1F35D","unicode_version":"6.0"},{"name":"roasted sweet potato","tags":[],"emoji":"🍠","aliases":["sweet_potato"],"category":"Food & Drink","codepoints":"U+1F360","unicode_version":"6.0"},{"name":"oden","tags":[],"emoji":"🍢","aliases":["oden"],"category":"Food & Drink","codepoints":"U+1F362","unicode_version":"6.0"},{"name":"sushi","tags":[],"emoji":"🍣","aliases":["sushi"],"category":"Food & Drink","codepoints":"U+1F363","unicode_version":"6.0"},{"name":"fried shrimp","tags":["tempura"],"emoji":"🍤","aliases":["fried_shrimp"],"category":"Food & Drink","codepoints":"U+1F364","unicode_version":"6.0"},{"name":"fish cake with swirl","tags":[],"emoji":"🍥","aliases":["fish_cake"],"category":"Food & Drink","codepoints":"U+1F365","unicode_version":"6.0"},{"name":"moon cake","tags":[],"emoji":"🥮","aliases":["moon_cake"],"category":"Food & Drink","codepoints":"U+1F96E","unicode_version":"11.0"},{"name":"dango","tags":[],"emoji":"🍡","aliases":["dango"],"category":"Food & Drink","codepoints":"U+1F361","unicode_version":"6.0"},{"name":"dumpling","tags":[],"emoji":"🥟","aliases":["dumpling"],"category":"Food & Drink","codepoints":"U+1F95F","unicode_version":"11.0"},{"name":"fortune cookie","tags":[],"emoji":"🥠","aliases":["fortune_cookie"],"category":"Food & Drink","codepoints":"U+1F960","unicode_version":"11.0"},{"name":"takeout box","tags":[],"emoji":"🥡","aliases":["takeout_box"],"category":"Food & Drink","codepoints":"U+1F961","unicode_version":"11.0"},{"name":"crab","tags":[],"emoji":"🦀","aliases":["crab"],"category":"Food & Drink","codepoints":"U+1F980","unicode_version":"8.0"},{"name":"lobster","tags":[],"emoji":"🦞","aliases":["lobster"],"category":"Food & Drink","codepoints":"U+1F99E","unicode_version":"11.0"},{"name":"shrimp","tags":[],"emoji":"🦐","aliases":["shrimp"],"category":"Food & Drink","codepoints":"U+1F990","unicode_version":"9.0"},{"name":"squid","tags":[],"emoji":"🦑","aliases":["squid"],"category":"Food & Drink","codepoints":"U+1F991","unicode_version":"9.0"},{"name":"oyster","tags":[],"emoji":"🦪","aliases":["oyster"],"category":"Food & Drink","codepoints":"U+1F9AA","unicode_version":"12.0"},{"name":"soft ice cream","tags":[],"emoji":"🍦","aliases":["icecream"],"category":"Food & Drink","codepoints":"U+1F366","unicode_version":"6.0"},{"name":"shaved ice","tags":[],"emoji":"🍧","aliases":["shaved_ice"],"category":"Food & Drink","codepoints":"U+1F367","unicode_version":"6.0"},{"name":"ice cream","tags":[],"emoji":"🍨","aliases":["ice_cream"],"category":"Food & Drink","codepoints":"U+1F368","unicode_version":"6.0"},{"name":"doughnut","tags":[],"emoji":"🍩","aliases":["doughnut"],"category":"Food & Drink","codepoints":"U+1F369","unicode_version":"6.0"},{"name":"cookie","tags":[],"emoji":"🍪","aliases":["cookie"],"category":"Food & Drink","codepoints":"U+1F36A","unicode_version":"6.0"},{"name":"birthday cake","tags":["party"],"emoji":"🎂","aliases":["birthday"],"category":"Food & Drink","codepoints":"U+1F382","unicode_version":"6.0"},{"name":"shortcake","tags":["dessert"],"emoji":"🍰","aliases":["cake"],"category":"Food & Drink","codepoints":"U+1F370","unicode_version":"6.0"},{"name":"cupcake","tags":[],"emoji":"🧁","aliases":["cupcake"],"category":"Food & Drink","codepoints":"U+1F9C1","unicode_version":"11.0"}],"category":"Food & Drink"},"meta":{"timestamp":"2026-05-30T18:16:51.188Z","request_id":"d5d1cf12-62d7-4f9f-a1fd-2b541ba55357"},"status":"ok","message":"Category retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/emoji":{"get":{"operationId":"get_v1_emoji","tags":["Emoji"],"summary":"Lookup one emoji","description":"","parameters":[{"name":"alias","in":"query","required":true,"description":"Alias (e.g. rocket, :fire:) or the emoji character","schema":{"type":"string"},"example":"rocket"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"rocket","tags":["ship","launch"],"emoji":"🚀","aliases":["rocket"],"category":"Travel & Places","codepoints":"U+1F680","unicode_version":"6.0"},"meta":{"timestamp":"2026-05-30T18:16:51.273Z","request_id":"079ab25b-0562-4028-812a-e771a9f75ce9"},"status":"ok","message":"Emoji retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/random":{"get":{"operationId":"get_v1_random","tags":["Emoji"],"summary":"Random emojis","description":"","parameters":[{"name":"count","in":"query","required":false,"description":"1-50 (default 1)","schema":{"type":"string"},"example":"3"},{"name":"category","in":"query","required":false,"description":"Limit to a category","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":3,"emojis":[{"name":"chains","tags":[],"emoji":"⛓️","aliases":["chains"],"category":"Objects","codepoints":"U+26D3 U+FE0F","unicode_version":"5.2"},{"name":"Libra","tags":[],"emoji":"♎","aliases":["libra"],"category":"Symbols","codepoints":"U+264E","unicode_version":""},{"name":"woman vampire","tags":[],"emoji":"🧛‍♀️","aliases":["vampire_woman"],"category":"People & Body","codepoints":"U+1F9DB U+200D U+2640 U+FE0F","unicode_version":"11.0"}]},"meta":{"timestamp":"2026-05-30T18:16:51.332Z","request_id":"66a1c1f1-8ac9-444b-8da9-0e64d9380692"},"status":"ok","message":"Random emojis retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Emoji"],"summary":"Search emojis","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Name, keyword, alias or tag","schema":{"type":"string"},"example":"happy"},{"name":"limit","in":"query","required":false,"description":"1-200 (default 30)","schema":{"type":"string"},"example":"30"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":4,"query":"happy","emojis":[{"name":"grinning face","tags":["smile","happy"],"emoji":"😀","aliases":["grinning"],"category":"Smileys & Emotion","codepoints":"U+1F600","unicode_version":"6.1"},{"name":"grinning face with big eyes","tags":["happy","joy","haha"],"emoji":"😃","aliases":["smiley"],"category":"Smileys & Emotion","codepoints":"U+1F603","unicode_version":"6.0"},{"name":"grinning face with smiling eyes","tags":["happy","joy","laugh","pleased"],"emoji":"😄","aliases":["smile"],"category":"Smileys & Emotion","codepoints":"U+1F604","unicode_version":"6.0"},{"name":"grinning squinting face","tags":["happy","haha"],"emoji":"😆","aliases":["laughing","satisfied"],"category":"Smileys & Emotion","codepoints":"U+1F606","unicode_version":"6.0"}]},"meta":{"timestamp":"2026-05-30T18:16:51.413Z","request_id":"6c45bd1a-e100-4697-8206-891efbf81dbd"},"status":"ok","message":"Search completed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":5000,"rps_limit":3,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":500,"monthly_call_quota":150000,"rps_limit":12,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1400,"monthly_call_quota":1000000,"rps_limit":30,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3800,"monthly_call_quota":6000000,"rps_limit":80,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/emoji-api"}