# Urban Dictionary API > 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. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/urbandict-api/..." ``` ## Pricing - **Free** (Free) — 2,000 calls/Mo, 2 req/s - **Starter** ($5/Mo) — 45,000 calls/Mo, 5 req/s - **Pro** ($18/Mo) — 200,000 calls/Mo, 12 req/s - **Mega** ($49/Mo) — 750,000 calls/Mo, 35 req/s ## Endpoints ### Slang #### `GET /v1/autocomplete` — Term suggestions **Parameters:** - `term` (query, required, string) — Partial term, e.g. ye Example: `ye` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/urbandict-api/v1/autocomplete?term=ye" ``` **Response:** ```json { "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 missi …(truncated, see openapi.json for full schema) ``` #### `GET /v1/define` — Definitions for a slang term **Parameters:** - `term` (query, required, string) — Slang term, e.g. yeet Example: `yeet` - `limit` (query, optional, string) — Max definitions (1-50) **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/urbandict-api/v1/define?term=yeet" ``` **Response:** ```json { "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, "a …(truncated, see openapi.json for full schema) ``` #### `GET /v1/random` — Random definitions **Parameters:** - `limit` (query, optional, string) — Max results (1-20) **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/urbandict-api/v1/random" ``` **Response:** ```json { "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", …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Usage notes **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/urbandict-api/v1/meta" ``` **Response:** ```json { "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 } ``` --- Marketplace page: https://www.oanor.com/api/urbandict-api OpenAPI spec: https://www.oanor.com/api/urbandict-api/openapi.json