Skip to content
GET /v1/define

Definitions for a slang term

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/urbandict-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/urbandict-api/v1/define" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/urbandict-api/v1/define", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/urbandict-api/v1/define");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/urbandict-api/v1/define",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "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,
                "auth
…