# 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.

- Page: https://fous.com/methods/urbandictionary.com/list-words-of-the-day
- Method: `urbandictionary.com/list_words_of_the_day`, version 1
- Website: urbandictionary.com
- Returns: featured date, word, meaning, example, thumbs up/down, definition link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `max_results` | integer | no |  | Most featured words to return, from 1 to 30. Example: 10. Default 10. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{}
```

Its output:

```json
{
  "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"
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
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":{}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## 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

## Input schema

```json
{
  "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

```json
{
  "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"
          }
        }
      }
    }
  }
}
```

## See more

- [Urban Dictionary API: Define slang term](https://fous.com/methods/urbandictionary.com/define-slang.md): 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.
- [Techmeme API: List top stories](https://fous.com/methods/techmeme.com/list-top-stories.md): Lists 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.
- [Merriam-Webster API: Get Merriam-Webster Word of the Day](https://fous.com/methods/merriam-webster.com/get-word-of-the-day.md): Gets 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.
- [Product Hunt API: List daily launches](https://fous.com/methods/producthunt.com/list-launches.md): Lists 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.
- [The New York Times API: List headlines](https://fous.com/methods/nytimes.com/list-headlines.md): Lists 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.
- [Medium API: List a writer's or publication's latest articles](https://fous.com/methods/medium.com/list-author-articles.md): Lists 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.
- [The Verge API: List headlines](https://fous.com/methods/theverge.com/list-headlines.md): Lists The Verge story headlines, including quick posts, in the order shown on a section page. Archive pages are added when more stories are needed.
- [AP News API: List headlines](https://fous.com/methods/apnews.com/list-headlines.md): Lists 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.
- [All Urban Dictionary methods](https://fous.com/methods/urbandictionary.com.md)