Urban Dictionary API: Define slang term
Gets Urban Dictionary definitions for a slang word or phrase in the site's order, with examples, votes, author and date. Returns an empty list when the term has no definitions.
Unofficial. Not affiliated with or endorsed by Urban Dictionary.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Term, required
term Slang word or phrase to define, for example rizz.
no cap
- Max Results optional
max_results Maximum definitions to return, for example 5.
10
Whole number from 1 to 20. Default
5.
Input as JSON
{ "term": "no cap", "max_results": 10}Output
{ "definitions": [ { "word": "No cap", "author": "daybird", "example": "I would only get perms because people who wear pullouts are fake, no cap.", "meaning": "The use of the phrase \"no cap\" is meant to convey authenticity and truth. The phrase originated in reference to decorative gold teeth, which can be divided into two distinct varieties: permanent gold teeth (aka \"perms\") or caps (aka \"pullouts\"). Whereas caps can be pulled out with ease, perms, as th…", "thumbs_up": 0, "thumbs_down": 0, "date_written": "2020-08-27", "definition_id": "15274482", "definition_link": "https://www.urbandictionary.com/define.php?term=No%20cap#15274482" }, { "word": "No cap", "author": "Leelee😈", "example": "That food was good no cap \nI hit that bit no cap", "meaning": "No cap basically mean that their not lying or capping like they did something.\nSometimes ppl write it like this🙅🏽 ♀️🧢or 🚫🧢 different ways", "thumbs_up": 0, "thumbs_down": 0, "date_written": "2018-06-08", "definition_id": "12941023", "definition_link": "https://www.urbandictionary.com/define.php?term=No%20cap#12941023" }, { "word": "no cap", "author": "TimeForAVibeCheck", "example": "“No cap, this pizza is amazing!”\n“I think I actually like Ty, no cap.”\n“Dude, I’m serious about this— no cap.”", "meaning": "A phrase that is akin to “it is true that” or “I think that”, “no cap” is often used to describe an opinionated statement or a statement that is believed to be true. Stemming from the verb capping (basically, “to lie”), it quite literally means “no lie.” Because of this, no cap can be used to descri…", "thumbs_up": 0, "thumbs_down": 0, "date_written": "2019-12-24", "definition_id": "14573058", "definition_link": "https://www.urbandictionary.com/define.php?term=no%20cap#14573058" } ]}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"urbandictionary.com/define_slang","input":{"term":"no cap","max_results":10}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "urbandictionary.com/define_slang" , "input": { "term": "no cap", "max_results": 10 }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "urbandictionary.com/define_slang" , "input": { "term": "no cap", "max_results": 10 } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run urbandictionary.com/define_slang# with {"term":"no cap","max_results":10}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "term" ], "properties": { "term": { "type": "string", "minLength": 1, "description": "Slang word or phrase to define, for example rizz." }, "max_results": { "type": "integer", "default": 5, "maximum": 20, "minimum": 1, "description": "Maximum definitions to return, for example 5." } }}Output schema
{ "type": "object", "required": [ "definitions" ], "properties": { "definitions": { "type": "array", "items": { "type": "object", "required": [ "word", "meaning", "example", "thumbs_up", "thumbs_down", "author", "date_written", "definition_link", "definition_id" ], "properties": { "word": { "type": "string", "description": "Word or phrase as shown." }, "author": { "type": [ "string", "null" ], "description": "Name of the definition author." }, "example": { "type": [ "string", "null" ], "description": "Usage example as plain text, if available." }, "meaning": { "type": "string", "description": "Definition text without linked-word markup." }, "thumbs_up": { "type": "integer", "description": "Number of upvotes." }, "thumbs_down": { "type": "integer", "description": "Number of downvotes." }, "date_written": { "type": [ "string", "null" ], "format": "date", "description": "Date the definition was written." }, "definition_id": { "type": "string", "description": "Urban Dictionary definition ID." }, "definition_link": { "type": "string", "description": "Link to the definition on its page." } }, "additionalProperties": false }, "description": "Definitions in the order shown on Urban Dictionary." } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
urbandictionary.com/define_slang- Returns
- word, meaning, example, thumbs up and down, author, date written, definition link and ID
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method urbandictionary.com/define_slang with the inputs above.
Ask your agent
- What does 'rizz' mean on Urban Dictionary? Show me the top 3 definitions with examples and vote counts.
- I keep hearing 'no cap' in group chats, can you pull up the most upvoted definitions with who wrote them and when?
- Get me up to 10 definitions for the slang 'delulu', ordered the way the site lists them.
- Find definitions for 'bussin' including thumbs up and down counts and the link to each entry.
- Look up the slang phrase 'touch grass' and give me the first 5 definitions with their IDs and dates written.
See more
All Urban Dictionary methodsLists Urban Dictionary's Words of the Day, newest first. Each word comes with its featured date, definition, example, votes and definition link.
urbandictionary.com/list_words_of_the_dayExplains a finance, business, or investing term using its Investopedia dictionary article.
investopedia.com/define_termLooks up an English word on Dictionary.com and returns its pronunciation, audio link, numbered definitions per dialect with examples, word origin and first recorded use.
dictionary.com/define_wordLooks up a word or phrase in Merriam-Webster's dictionary and returns its pronunciation, definitions, examples and word history.
merriam-webster.com/define_wordGets a word's Thesaurus.com meanings in site order, with part of speech, short meaning, synonyms and antonyms ranked strongest, strong or weak.
dictionary.com/get_synonymsLooks up a word or phrase on Cambridge Dictionary and returns its ordered meanings, example sentences, grammar labels and UK and US pronunciations.
dictionary.cambridge.org/define_wordLooks up a word on its public Merriam-Webster thesaurus page and returns each meaning with its example, synonyms, antonyms and related words.
merriam-webster.com/get_synonymsFinds words with similar meanings, opposite meanings, adjectives describing a word, or strongly associated words, ordered by relevance.
rhymezone.com/get_related_words