Skip to main content

​
Search Term

Look up slang terms and their definitions from Urban Dictionary.

​
Endpoint

GET /api/urbandictionary

​
Query Parameters

​
term
string
required
Slang term to search for

​
Example Request

curl -X GET "https://rocks.rive.wtf/api/urbandictionary?term=yeet" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response Example

{
  "success": true,
  "list": [
    {
      "definition": "A word one may scream while [propelling] an object through the air at [alarming] speeds, [heights], and etc.",
      "example": "\"YEET!\" Mei [screamed], [hurling] [the football] at her catcaller's head.",
      "thumbs_down": 0,
      "thumbs_up": 0,
      "word": "yeet"
    },
    {
      "definition": "An extremely expressive word that can be used in many situations.",
      "example": "[I bet] [I can] [hit that] bird with this rock. YEET!",
      "thumbs_down": 0,
      "thumbs_up": 0,
      "word": "yeet"
    }
  ]
}

​
Response Fields

​
success
boolean
Indicates if the request was successful
​
list
array
Array of definition objects for the searched term
Urban Dictionary contains user-generated content that may include offensive language or adult themes. Results are returned as submitted by users. Text in square brackets [like this] indicates hyperlinks to related terms on Urban Dictionary.
Multiple definitions are returned for each term, representing different interpretations and usages of the slang. The API returns up to 10 definitions per search.

​
Use Cases

Discord Slang Bot

Help users understand internet slang

Content Moderation

Identify slang terms in user content

Language Learning

Learn modern colloquial expressions

Chatbots

Add slang understanding to bots

​
Handling Bracketed Text

Urban Dictionary definitions include bracketed text [like this] to reference related terms. You can:
  1. Remove brackets entirely - Clean, simple text
text.replace(/\[|\]/g, '')
  1. Keep brackets - Preserve original formatting
// Use text as-is
  1. Convert to links - Make references clickable
text.replace(/\[([^\]]+)\]/g, (match, word) => {
  return `<a href="https://urbandictionary.com/define.php?term=${encodeURIComponent(word)}">${word}</a>`;
})