Urban Dictionary API: List words of the day
Lists Urban Dictionary's Words of the Day, newest first. Each word comes with its featured date, definition, example, votes and definition link.
Unofficial. Not affiliated with or endorsed by Urban Dictionary.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Max Results optional
max_results Most featured words to return, from 1 to 30. Example: 10.
10 (default)
Whole number from 1 to 30.
Input as JSON
{}Output
{ "words_of_the_day": [ { "word": "Plate of Brown", "example": "Wanna go to meal hall & grab a plate of brown ?", "meaning": "A plate of brown consists of foods that have little to no nutritional value, and are typically deep fried. A true plate of brown will also be accompanied by a dark soda.", "thumbs_up": 0, "thumbs_down": 0, "featured_date": "2026-10-22", "definition_link": "https://www.urbandictionary.com/define.php?term=Plate+of+Brown&defid=15323121" }, { "word": "Larpenomics", "example": "Andrew Tate has mastered the field of larpenomics", "meaning": "When finance content creators rent out fancy cars and flex cash to seem richer than they really are in order to promote and sell their “ get rich quick” courses.", "thumbs_up": 0, "thumbs_down": 0, "featured_date": "2026-10-21", "definition_link": "https://www.urbandictionary.com/define.php?term=Larpenomics&defid=18751622" }, { "word": "Palmela Handerson", "example": "Girlfriend: What are you going to do for the next week while I'm on holiday ? Boyfriend: Have a visit from Palmela Handerson of course !", "meaning": "Your hand that you masturbate with.", "thumbs_up": 0, "thumbs_down": 0, "featured_date": "2026-10-20", "definition_link": "https://www.urbandictionary.com/define.php?term=Palmela+Handerson&defid=12976194" } ]}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"urbandictionary.com/list_words_of_the_day","input":{}}' # 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/list_words_of_the_day" , "input": {}})# 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/list_words_of_the_day" , "input": {} }), 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/list_words_of_the_day# with {}"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": [], "properties": { "max_results": { "type": "integer", "default": 10, "maximum": 30, "minimum": 1, "description": "Most featured words to return, from 1 to 30. Example: 10." } }}Output schema
{ "type": "object", "required": [ "words_of_the_day" ], "properties": { "words_of_the_day": { "type": "array", "items": { "type": "object", "required": [ "featured_date", "word", "meaning", "thumbs_up", "thumbs_down", "definition_link" ], "properties": { "word": { "type": "string" }, "example": { "type": [ "string", "null" ] }, "meaning": { "type": "string" }, "thumbs_up": { "type": "integer" }, "thumbs_down": { "type": "integer" }, "featured_date": { "type": "string" }, "definition_link": { "type": "string" } } } } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
urbandictionary.com/list_words_of_the_day- Returns
- featured date, word, meaning, example, thumbs up/down, definition link
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/list_words_of_the_day with the inputs above.
Ask your agent
- Show me the last 15 Urban Dictionary words of the day with their definitions and example sentences
- What slang words were featured recently on urbandictionary.com? Give me the top 8 with thumbs up and down counts
- I want a list of the newest word-of-the-day entries, including the date each was featured and a link to the definition
- Pull up the 20 most recent featured slang terms with their meanings and vote totals
- Give me the latest 5 words of the day from Urban Dictionary, newest first, with examples and definition links
See more
All Urban Dictionary methodsGets 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.
urbandictionary.com/define_slangLists Techmeme's leading stories in page order, with each story's original article and linked coverage. Uses the live front page, or the evening archive for a given date.
techmeme.com/list_top_storiesGets Merriam-Webster's Word of the Day for today or a past archive date, with its meaning, example, pronunciation and background note. Dates without a published entry are unavailable.
merriam-webster.com/get_word_of_the_dayLists featured launches in Product Hunt's daily leaderboard order for a given US Pacific day, with each product's website when its public page shows one.
producthunt.com/list_launchesLists current New York Times headlines with summaries, authors, images and publication times, in the order shown on the chosen section page (top stories or a section). Video-only items, ads and promotions are left out; times come from the section's feed and may be missing.
nytimes.com/list_headlinesLists the latest public articles by a Medium writer or publication (by username, publication name or Medium link), with dates, reading times, claps, member-only labels and tags.
medium.com/list_author_articlesLists The Verge story headlines, including quick posts, in the order shown on a section page. Archive pages are added when more stories are needed.
theverge.com/list_headlinesLists AP News headlines in the order shown on a public section page, up to 50 stories. Author credits and the article section are added for the first 20 articles only.
apnews.com/list_headlines