{"openapi":"3.1.0","info":{"title":"Urban Dictionary API","version":"1.0.0","description":"Urban Dictionary as an API — the crowd-sourced dictionary of slang, internet terms, memes, abbreviations and pop-culture expressions. Where a formal dictionary stops, Urban Dictionary explains the words people actually use online and in conversation: youth slang, gaming and meme vocabulary, acronyms, regional expressions and the ever-changing language of the internet. This API wraps the official Urban Dictionary service into a clean JSON interface. /v1/define?term=yeet returns the community definitions for a slang term, each with a real usage example, the contributing author, the up- and down-vote counts and a computed net score, sorted best-first so the most upvoted meaning comes first (or pass defid to fetch one specific definition by its id). /v1/random returns a batch of random definitions — perfect for a slang word-of-the-day, discovery features or fun. /v1/autocomplete?term=ye returns term suggestions as the user types, each with a short preview, for building search-as-you-type experiences. Ideal for chat and social apps decoding slang, language-learning and culture tools, moderation context, trivia and entertainment bots, and word-of-the-day widgets. Definitions are user-submitted and, by the nature of the source, may contain strong or NSFW language. Data from Urban Dictionary. For formal definitions, pronunciation and etymology, pair this with a standard dictionary API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/urbandict-api","description":"oanor gateway"}],"tags":[{"name":"Slang"},{"name":"Meta"}],"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/autocomplete":{"get":{"operationId":"get_v1_autocomplete","tags":["Slang"],"summary":"Term suggestions","description":"","parameters":[{"name":"term","in":"query","required":true,"description":"Partial term, e.g. ye","schema":{"type":"string"},"example":"ye"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"term":"ye","count":10,"suggestions":[{"term":"yeet","preview":"1. Yes 2. Can be a wild card for any curse word"},{"term":"yes","preview":"The acceptance of an object or an invitation."},{"term":"yee","preview":"1)adv. okay;fine;yes"},{"term":"Yellow","preview":"A pretty color."},{"term":"yesn't","preview":"Conj. Meaning Maby yes and maby no"},{"term":"ye","preview":"Second person personal pronoun of the subjective form. Middle English for \"you all\""},{"term":"yeah","preview":"An adverb that makes everything sound better. Said with emphasis."},{"term":"yee-yee","preview":"An asian / Oriental girl. So named from the high-pitched sound they make when penetrated by anything"},{"term":"Yesh","preview":"A somewhat drunken way of saying \"Yes\". A pretty useful and pointless internet term."},{"term":"yeti","preview":"Thought to be the missing link, is actually an advanced version of human that tends to shy away from"}]},"meta":{"timestamp":"2026-06-01T16:23:49.517Z","request_id":"3dbb31e4-cfd0-4fcf-8ff0-f6ad4b6337e2"},"status":"ok","message":"Suggestions 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/define":{"get":{"operationId":"get_v1_define","tags":["Slang"],"summary":"Definitions for a slang term","description":"","parameters":[{"name":"term","in":"query","required":true,"description":"Slang term, e.g. yeet","schema":{"type":"string"},"example":"yeet"},{"name":"limit","in":"query","required":false,"description":"Max definitions (1-50)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"term":"yeet","count":10,"total":10,"definitions":[{"word":"Yeet","defid":12339851,"score":0,"author":"Le anonymous ","example":"Alex finishes his [soda] and proceeds to yeet his empty can into a [trash bin]\n\nAlex (while [throwing] the can): “YEET!”","permalink":"https://www.urbandictionary.com/define.php?term=Yeet&defid=12339851","thumbs_up":0,"definition":"To [discard] an [item] at a high [velocity]","written_on":"2018-04-22T00:00:00.000Z","thumbs_down":0},{"word":"yeet","defid":12087363,"score":0,"author":"carryingthebanner","example":"\"YEET!\" Mei screamed, [hurling] the [football] at her catcaller's [head].","permalink":"https://www.urbandictionary.com/define.php?term=yeet&defid=12087363","thumbs_up":0,"definition":"A word [one] [may] [scream] while propelling an object through the air at alarming speeds, heights, and etc.","written_on":"2017-10-23T00:00:00.000Z","thumbs_down":0},{"word":"YEET","defid":13856827,"score":0,"author":"eggman16","example":"\"YEET\"","permalink":"https://www.urbandictionary.com/define.php?term=YEET&defid=13856827","thumbs_up":0,"definition":"[Said] when throwing [something] for no [reason] whatsoever.","written_on":"2019-04-29T00:00:00.000Z","thumbs_down":0},{"word":"yeet","defid":11413971,"score":0,"author":"BiggieBigelow","example":"I [bet] I can [hit that] [bird] with this rock. YEET!","permalink":"https://www.urbandictionary.com/define.php?term=yeet&defid=11413971","thumbs_up":0,"definition":"An extremely expressive word that can be used in many situations.\nOn [one] end of the spectrum, \"yeet\" can be bellowed with a full, guttural sound whilst lobbing an object furiously to assert authority (great for water balloons and empty containers). On the other hand, \"yeet\" can be used gently, like the faint brush of a butterfly's wings as it crosses [one]'s lips, as [one] completes a difficult task (i.e. boss in a difficult game, tough question on a math [test]).","written_on":"2017-04-09T00:00:00.000Z","thumbs_down":0},{"word":"Yeet","defid":14578720,"score":0,"author":"sans.....","example":"[Shrek] proceeded to Yeet [Jakob] after he went in his [swamp]","permalink":"https://www.urbandictionary.com/define.php?term=Yeet&defid=14578720","thumbs_up":0,"definition":"Yeet means [throwing] [something] very very hard very very [fast].","written_on":"2019-12-26T00:00:00.000Z","thumbs_down":0},{"word":"yeet","defid":13170345,"score":0,"author":"bitchwithapen","example":"[1]. Ma'm, I know I shouldn't have yote that pencil, but the student that I yote it at was being a [real] dickwad.\n\n2. Carlos: *dabs*\nLiam: YEEEET!\n\n3. Jenna: this stupid remote control doesn't work. I hate it.\n\nMaegan: Just yeet it in the [trash], silly!","permalink":"https://www.urbandictionary.com/define.php?term=yeet&defid=13170345","thumbs_up":0,"definition":"Yeet has many defenitions, and can be used in many contexts.\n\n[1]) Yeet: to send something from point A to point B with exaggerated force. This [definition] comes from the famous video [clip] featuring a soda can and a crowded hallway.\n\n2) Yeet: an interjection following or said along with an action. For example, if someone hit a [whip] then they could use the word yeet to punctuate said action. Please note that someone can punctuate someone else's action.\n\n3) Yeet: to get rid of, or toss (generally discarding.)\n\nDON'T FORGET:\n\nWhen using the word yeet, [one] must consider the present tense (to yeet), the past tense (have yote) and the future tense (will yeet).\n\nPlease note that the number of E's used in the word only changes its meaning if it is being used as the above shown first definition. Otherwise, you [may] [add] as many E's as you wish.","written_on":"2018-09-02T00:00:00.000Z","thumbs_down":0},{"word":"Yeet","defid":11814253,"score":0,"author":"Delyrious Boy","example":"\"[Hi]\", [friendly] person [said].\n\"Yeet!\"","permalink":"https://www.urbandictionary.com/define.php?term=Yeet&defid=11814253","thumbs_up":0,"definition":"n. Everyone thinks they [know] what it means until they [realize] they have no f*cking [clue]","written_on":"2017-07-23T00:00:00.000Z","thumbs_down":0},{"word":"Yeet","defid":13014665,"score":0,"author":"UltimateSemanticist","example":"Person [1]: \"I throw this object over there!\"\nPerson 2: \"How hard will you throw it?\"\nPerson [1]: \"Hard enough to apply an impulse of 500Ns!\"\nPerson 2: \"For your object the relative maximum possible impulse in air is 550Ns, so you will actually yeet it, not throw it\"\nPerson [1]: \"You're [mum] gey stop correcting me\"","permalink":"https://www.urbandictionary.com/define.php?term=Yeet&defid=13014665","thumbs_up":0,"definition":"When you apply 80%+ of the relative maximum possible impulse to an object upon propelling it from your [hands].\n\nNotes:\n-The maximum possible impulse is RELATIVE to what your maximum is (if you were to [use] the general maximum, any impulse would be ~0% of the maximum, as the maximum is [now] infinity). Your maximum is defined to be the largest impulse you can exert on the object.\n-Any object propelled with less than 80% of the maximum possible impulse is considered to be thrown, and not [yote]","written_on":"2018-06-20T00:00:00.000Z","thumbs_down":0},{"word":"Yeet","defid":11489076,"score":0,"author":"Mccnanana","example":"\"[LOOK AT] MY [SPARKLY] [CROCS] YEETTTTTT\"","permalink":"https://www.urbandictionary.com/define.php?term=Yeet&defid=11489076","thumbs_up":0,"definition":"Your [reaction] when [your mum] buys you some fresh [crocs]","written_on":"2017-04-27T00:00:00.000Z","thumbs_down":0},{"word":"Yeet","defid":7708803,"score":0,"author":"2400 SAT Score","example":"John: \"Hey man! Happy 21st birthday! I got you this for your special day, [hope] you enjoy!\"\n[Jack]: \"KidzBop? Are you serious?\"\nJohn: \"I thought you liked it? It has some nice songs on it and...\"\n[Jack]: \"YEET!\"","permalink":"https://www.urbandictionary.com/define.php?term=Yeet&defid=7708803","thumbs_up":0,"definition":"To violently [throw] an object that you deem to be [worthless], inferior or just plain garbage. It is not uncommon for the person participating in this act to yell the word, \"YEET!\" at the top of his or her lungs, notifying all surrounding individuals in the area that said object is [useless].","written_on":"2014-04-13T00:00:00.000Z","thumbs_down":0}]},"meta":{"timestamp":"2026-06-01T16:23:49.797Z","request_id":"d05482c3-77d2-4f9c-9e49-6d644c17b540"},"status":"ok","message":"Definitions 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":["Slang"],"summary":"Random definitions","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Max results (1-20)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":10,"definitions":[{"word":"fapsturbate","defid":8135873,"score":0,"author":"put a dick all up inside her","example":"[Isabelle] likes to fapsturbate to her [boyfriend] when he [faps] on a skype call.","permalink":"https://www.urbandictionary.com/define.php?term=fapsturbate&defid=8135873","thumbs_up":0,"definition":"Fapsturbating is when someone ([girl] or guy) masturbates to [a guy] [fapping].","written_on":"2015-03-02T00:00:00.000Z","thumbs_down":0},{"word":"kaknook","defid":3431741,"score":0,"author":"alisha danielle t","example":"\"[Lauren] and I were kaknooking about [Jane]'[s] party tomorrow.\"\n\n\"I will get back at her, I'm doing to kaknook tonight\"","permalink":"https://www.urbandictionary.com/define.php?term=kaknook&defid=3431741","thumbs_up":0,"definition":"to plot against; to [plan] deceit, evil, or plundering activities; to think up [something] horrible; to plot [revenge]","written_on":"2009-03-01T00:00:00.000Z","thumbs_down":0},{"word":"Mom's gonna punt you to the moon","defid":18062343,"score":0,"author":"Not_actually_blind","example":"Younger sibling: Did you hear that [dad] bought me [robux]!!!???\nOlder sibling: Shut up mom's gonna punt you to the [moon].","permalink":"https://www.urbandictionary.com/define.php?term=Mom%27s%20gonna%20punt%20you%20to%20the%20moon&defid=18062343","thumbs_up":0,"definition":"A common saying among siblings being [loud] at 10pm. The [mother] won't actually [punt] you. But will beat your ass if you don't quiet down.","written_on":"2023-12-29T20:21:26.000Z","thumbs_down":0},{"word":"Charismatic","defid":15452749,"score":0,"author":"Suckmy10imchghostdick","example":"\"charismatic is so [sweet]\" \"omg i love charismatic he stayed [up all night] playing among us with me when i had no [one] else,","permalink":"https://www.urbandictionary.com/define.php?term=Charismatic&defid=15452749","thumbs_up":0,"definition":"A amazing person who will [always] be there when u need them. Funny as hell and just a good peraon in general. Will support you in everything u do. They will spemd all night playing [video games] with you. If u are special to thia person you will always be on there [mind]. Your welcome MerakiXD","written_on":"2020-11-04T22:16:05.000Z","thumbs_down":0},{"word":"evil fruits","defid":1929648,"score":0,"author":"Evil Orange","example":"\"Chaos, [panic] and [disorder] - [Evil] Fruits were here...\"","permalink":"https://www.urbandictionary.com/define.php?term=evil%20fruits&defid=1929648","thumbs_up":0,"definition":"A community of [real] evil shooters... \n\nYou should not taste them ! \nYou should not come in contact with them ! \nIf you [spot] them just try to hide or [run] !","written_on":"2006-08-21T00:00:00.000Z","thumbs_down":0},{"word":"glen arm","defid":1199490,"score":0,"author":"Emily Pavesich","example":"[blah] i [dunno] what this [means]","permalink":"https://www.urbandictionary.com/define.php?term=glen%20arm&defid=1199490","thumbs_up":0,"definition":"This doesn't have anything but houses and it reaches out a lot further than you think.  [Glen] Arm is [hick]-town in some areas like ie way down [glen] arm road but then near good ol jville its cool and where i live!  Check out j-ville and towson for two of the close hang outs of us [glen] arm teens!  Loch Raven reservoir is another cute little spot two minutes from us.  Nobody has ever really heard of \"glen arm\" but you say any of the surrounding areas its \"sure, sure\" or course but no knowledge of glen arm of course","written_on":"2005-04-19T00:00:00.000Z","thumbs_down":0},{"word":"Shawnee lower D hall boys bathroom","defid":17661061,"score":0,"author":"Dickballs420","example":"If you have a piss [kink] or a drug [problem], the Shawnee lower D hall [boys] bathroom is the place for you.","permalink":"https://www.urbandictionary.com/define.php?term=Shawnee%20lower%20D%20hall%20boys%20bathroom&defid=17661061","thumbs_up":0,"definition":"A godless land, a place with more [drugs] at any given point in time than Pablo Escobar has seen in his life. The floor is caked with enough piss to make a kinky [bastard] drop and start licking. There’s always one kid in there shitting his brains out. The graffiti on the stall walls can make a [KKK] meeting look tame.","written_on":"2023-02-07T08:22:00.000Z","thumbs_down":0},{"word":"American Idiot","defid":1065789,"score":0,"author":"andy","example":"American [Idiot] is the only album this [year] where every single [song] is great.","permalink":"https://www.urbandictionary.com/define.php?term=American%20Idiot&defid=1065789","thumbs_up":0,"definition":"[2004] Album release from \"Green Day,\" the influential punk/alternative rock band.  The concept is a rock opera following the lives of youth in a [world] they portray as [media] dominated and where they have no voice.","written_on":"2005-05-13T00:00:00.000Z","thumbs_down":0},{"word":"Hunt slut","defid":17741712,"score":0,"author":"Ep78","example":"Omg you're going on [another] [hunt] again with another guy . You're such a [hunt] slut","permalink":"https://www.urbandictionary.com/define.php?term=Hunt%20slut&defid=17741712","thumbs_up":0,"definition":"A [woman] who dates guys [just] to get places to hunt due to hunting [addiction]","written_on":"2023-04-06T09:38:57.000Z","thumbs_down":0},{"word":"pork roll","defid":1776122,"score":0,"author":"basileus","example":"I'd like a pork [roll], egg, and cheese -- [salt] pepper [ketchup].","permalink":"https://www.urbandictionary.com/define.php?term=pork%20roll&defid=1776122","thumbs_up":0,"definition":"Staple food of the [small], impoverished [Italian] colony known as New [Jersey].","written_on":"2006-05-30T00:00:00.000Z","thumbs_down":0}]},"meta":{"timestamp":"2026-06-01T16:23:49.994Z","request_id":"a2af1193-c41e-409e-af6c-b184aeaf84fa"},"status":"ok","message":"Random definitions 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/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Urban Dictionary is the crowd-sourced dictionary of slang, internet terms, memes and pop-culture expressions — the informal counterpart to a formal dictionary, for decoding youth/internet vocabulary. /v1/define?term=yeet = the community definitions for a slang term, each with a usage example, the author, the up/down vote counts and a computed score, sorted best-first (or pass defid=… to fetch one specific definition by its id); /v1/random = a batch of random definitions, good for word-of-the-day style features; /v1/autocomplete?term=ye = term suggestions as you type, each with a short preview. Definitions are user-submitted and may contain strong or NSFW language by nature of the source. Data from Urban Dictionary. For formal word definitions, pronunciation and etymology, use a standard dictionary API instead.","source":"Urban Dictionary API (api.urbandictionary.com)","endpoints":["/v1/define","/v1/random","/v1/autocomplete","/v1/meta"]},"meta":{"timestamp":"2026-06-01T16:23:50.075Z","request_id":"0cad91ae-386f-4274-a8c9-80706b9d9f2c"},"status":"ok","message":"Meta 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"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":500,"monthly_call_quota":45000,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1800,"monthly_call_quota":200000,"rps_limit":12,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":4900,"monthly_call_quota":750000,"rps_limit":35,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/urbandict-api"}