Urban Dictionary

Look slang up in Urban Dictionary, the crowd-written dictionary the internet has been adding to since 1999. Define a term and get the example sentence its author wrote, browse every definition a term has, follow the slang its definitions link out to, or ask simply whether a word is defined at all, which is what a workflow reading chat messages usually needs. It also serves autocomplete suggestions, random definitions and the words of the day, plus the spoken audio and share images the site makes for every definition. No account or API key is required. Definitions are user-submitted and are often explicit.

Actions

Action	What it does
Browse all of a term's definitions	Walk several pages of a term's definitions and get them back as one list, which is how to answer 'everything Urban Dictionary has on this' without a loop.
Check whether a term is defined	Answer whether Urban Dictionary holds any definition for a term, as a true or false a step can branch on.
Define a term	Look a slang term up and get a page of its definitions, each with the example sentence its author wrote, who wrote it and when.
Define several terms	Look several terms up at once and get the top definition of each, which is what a step that has just pulled the unfamiliar words out of a message wants.
Get a term's audio and images	Get the spoken recording of a term and the ready-made card image of each of its definitions, which is what a Slack post or a social post wants instead of a wall of text.
Get a term's related slang	List the other slang a term's definitions link to, ranked by how many of them mention it.
Get a term's top definition	Get only the top definition of a term, as flat fields, so a message can read the definition, the example and the link straight off the step without picking a row out of a list.
Get a term's usage examples	List the example sentences Urban Dictionary holds for a term, one per definition, beside the definition each one illustrates.
Get one definition by its link	Fetch exactly one definition, by the link or the id that identifies it.
Get random definitions	Get 10 random definitions from anywhere in Urban Dictionary, different on every run, which is what a slang-of-the-day post or a word-game workflow runs on.
Get the words of the day	Get the terms Urban Dictionary has picked as its word of the day, 10 per page, each with the day it was featured and the definition that went with it.
Suggest terms for a prefix	Get up to 10 real Urban Dictionary headwords that start with what has been typed so far, as a plain list of words.
Suggest terms with previews	The same suggestions as 'Suggest terms for a prefix', but each one carries the start of its top definition.

Browse all of a term's definitions

Walk several pages of a term's definitions and get them back as one list, which is how to answer 'everything Urban Dictionary has on this' without a loop. Pages are 10 definitions each and the step stops as soon as it reaches the end of the term, so a short term costs one request however high the page limit is set. It reports how many pages it read and whether it reached the end.

Inputs

TermtermtextRequired: The slang term to look up. A phrase works as well as a single word, and capitals do not matter: Urban Dictionary matches either way and answers with the spelling its authors used.
Most pages to readmax_pagesnumber: How many pages of 10 to walk through, at most. The step stops early as soon as it reaches the end of the term, so a term with 15 definitions costs 2 pages however high this is set.From 1 to 20. Default: 3.
Ordersorttext: What order to return the definitions in. Leave this empty to keep Urban Dictionary's own ranking, which puts the definition the site shows first at the top.One of: relevance (Top rated first: the order Urban Dictionary itself ranks them in), newest (Newest first: most recently written), oldest (Oldest first: the original definitions). Default: relevance.
Written on or afterwritten_afterdate: Keep only definitions submitted on or after this day. Leave this empty for no earliest date. Useful for telling new slang from a meaning a term has had since 2005.
Written on or beforewritten_beforedate: Keep only definitions submitted on or before this day. Leave this empty for no latest date.
Most rows to returnmax_resultsnumber: The most rows to return. Leave this empty to get all of them. The answer always reports the total, so you can see when there were more.From 1 to 500.

Outputs

countnumber
definitionslist
fetchednumber
foundtrue/false
matchednumber
pages_readnumber
reached_endtrue/false
requests_madenumber
termtext

Example output

{
  "count": 2,
  "definitions": [
    {
      "audio_url": "https://cdn.urbdic.com/audio/tts/4/c/4c1202-rizz.mp3?Expires=1788469939",
      "author": "bro got no rizz",
      "definition": "Another word for spitting game/how good you are with pulling people.",
      "definition_id": 17115763,
      "definition_markup": "Another word for spitting [game]/how good [you are] with pulling people.",
      "example": "Damn, that guy has no rizz.",
      "example_markup": "Damn, that guy has no [rizz].",
      "image_url": "https://udimg.com/v1/social/twitter.webp?word=Rizz",
      "linked_terms": [
        "game",
        "you are"
      ],
      "permalink": "https://www.urbandictionary.com/define.php?term=Rizz&defid=17115763",
      "term": "Rizz",
      "written_date": "2022-03-31",
      "written_on": "2022-03-31T10:36:17.000Z"
    },
    {
      "audio_url": "https://cdn.urbdic.com/audio/tts/4/c/4c1202-rizz.mp3?Expires=1788469939",
      "author": "unspoken rizz",
      "definition": "Short for charisma. The ability to charm someone.",
      "definition_id": 17233871,
      "definition_markup": "Short for [charisma]. The ability to [charm] someone.",
      "example": "He pulled her with pure rizz.",
      "example_markup": "He pulled her with pure rizz.",
      "image_url": "https://udimg.com/v1/social/twitter.webp?word=Rizz",
      "linked_terms": [
        "charisma",
        "charm"
      ],
      "permalink": "https://www.urbandictionary.com/define.php?term=Rizz&defid=17233871",
      "term": "Rizz",
      "written_date": "2022-09-04",
      "written_on": "2022-09-04T00:11:31.000Z"
    }
  ],
  "fetched": 24,
  "found": true,
  "matched": 24,
  "pages_read": 3,
  "reached_end": true,
  "requests_made": 3,
  "term": "Rizz"
}

Check whether a term is defined

Answer whether Urban Dictionary holds any definition for a term, as a true or false a step can branch on. A term nobody has defined answers false rather than failing the run, which is what makes this usable for screening words out of a message or deciding whether the rest of a workflow should go ahead.

Inputs

TermtermtextRequired: The slang term to look up. A phrase works as well as a single word, and capitals do not matter: Urban Dictionary matches either way and answers with the spelling its authors used.

Outputs

definition_count_on_pagenumber
existstrue/false
has_more_pagestrue/false
permalinktext
termtext
top_definitiontext

Example output

{
  "definition_count_on_page": 10,
  "exists": true,
  "has_more_pages": true,
  "permalink": "https://www.urbandictionary.com/define.php?term=Rizz&defid=17115763",
  "term": "Rizz",
  "top_definition": "Another word for spitting game/how good you are with pulling people."
}

Define a term

Look a slang term up and get a page of its definitions, each with the example sentence its author wrote, who wrote it and when. Urban Dictionary answers 10 at a time in its own ranking order, so the first one back is the definition the website shows first. Narrow the page by the date a definition was written, or reorder it oldest or newest first, to tell a term's new meaning from the one it had a decade ago. A term nobody has defined comes back empty rather than failing.

Inputs

TermtermtextRequired: The slang term to look up. A phrase works as well as a single word, and capitals do not matter: Urban Dictionary matches either way and answers with the spelling its authors used.
Pagepagenumber: Which page of 10 to fetch. Leave this empty for the first page, which holds the top definitions. Asking past the last page returns nothing rather than failing.From 1 to 1000.
Ordersorttext: What order to return the definitions in. Leave this empty to keep Urban Dictionary's own ranking, which puts the definition the site shows first at the top.One of: relevance (Top rated first: the order Urban Dictionary itself ranks them in), newest (Newest first: most recently written), oldest (Oldest first: the original definitions). Default: relevance.
Written on or afterwritten_afterdate: Keep only definitions submitted on or after this day. Leave this empty for no earliest date. Useful for telling new slang from a meaning a term has had since 2005.
Written on or beforewritten_beforedate: Keep only definitions submitted on or before this day. Leave this empty for no latest date.
Most rows to returnmax_resultsnumber: The most rows to return. Leave this empty to get all of them. The answer always reports the total, so you can see when there were more.From 1 to 500.

Outputs

countnumber
definitionslist
foundtrue/false
has_more_pagestrue/false
matchednumber
on_pagenumber
pagenumber
permalinktext
termtext
top_definitiontext
top_definition_idnumber

Example output

{
  "count": 2,
  "definitions": [
    {
      "audio_url": "https://cdn.urbdic.com/audio/tts/4/c/4c1202-rizz.mp3?Expires=1788469939",
      "author": "bro got no rizz",
      "definition": "Another word for spitting game/how good you are with pulling people.",
      "definition_id": 17115763,
      "definition_markup": "Another word for spitting [game]/how good [you are] with pulling people.",
      "example": "Damn, that guy has no rizz.",
      "example_markup": "Damn, that guy has no [rizz].",
      "image_url": "https://udimg.com/v1/social/twitter.webp?word=Rizz",
      "linked_terms": [
        "game",
        "you are"
      ],
      "permalink": "https://www.urbandictionary.com/define.php?term=Rizz&defid=17115763",
      "term": "Rizz",
      "written_date": "2022-03-31",
      "written_on": "2022-03-31T10:36:17.000Z"
    },
    {
      "audio_url": "https://cdn.urbdic.com/audio/tts/4/c/4c1202-rizz.mp3?Expires=1788469939",
      "author": "unspoken rizz",
      "definition": "Short for charisma. The ability to charm someone.",
      "definition_id": 17233871,
      "definition_markup": "Short for [charisma]. The ability to [charm] someone.",
      "example": "He pulled her with pure rizz.",
      "example_markup": "He pulled her with pure rizz.",
      "image_url": "https://udimg.com/v1/social/twitter.webp?word=Rizz",
      "linked_terms": [
        "charisma",
        "charm"
      ],
      "permalink": "https://www.urbandictionary.com/define.php?term=Rizz&defid=17233871",
      "term": "Rizz",
      "written_date": "2022-09-04",
      "written_on": "2022-09-04T00:11:31.000Z"
    }
  ],
  "found": true,
  "has_more_pages": true,
  "matched": 10,
  "on_page": 10,
  "page": 1,
  "permalink": "https://www.urbandictionary.com/define.php?term=Rizz&defid=17115763",
  "term": "Rizz",
  "top_definition": "Another word for spitting game/how good you are with pulling people.",
  "top_definition_id": 17115763
}

Define several terms

Look several terms up at once and get the top definition of each, which is what a step that has just pulled the unfamiliar words out of a message wants. A term nobody has defined is reported as not found rather than failing the whole list, and the found and not-found terms come back as their own lists so a later step can branch on either. At most 20 terms, because each one is a separate request.

Inputs

TermstermslistRequired: The terms to look up, one per row. At most 20 in one step, because each term is a separate request. Repeats are dropped.

Outputs

countnumber
foundlist
found_countnumber
not_foundlist
not_found_countnumber
requests_madenumber
resultslist

Example output

{
  "count": 2,
  "found": [
    "yeet"
  ],
  "found_count": 1,
  "not_found": [
    "zzzqqqxyzzy"
  ],
  "not_found_count": 1,
  "requests_made": 2,
  "results": [
    {
      "author": "sans.....",
      "definition": "Yeet means throwing something very very hard very very fast.",
      "definition_id": 14578720,
      "example": "He yeeted the ball across the field.",
      "found": true,
      "permalink": "https://www.urbandictionary.com/define.php?term=Yeet&defid=14578720",
      "term": "Yeet",
      "written_date": "2019-12-26"
    },
    {
      "author": "",
      "definition": "",
      "definition_id": 0,
      "example": "",
      "found": false,
      "permalink": "",
      "term": "zzzqqqxyzzy",
      "written_date": ""
    }
  ]
}

Get a term's audio and images

Get the spoken recording of a term and the ready-made card image of each of its definitions, which is what a Slack post or a social post wants instead of a wall of text. The audio link is signed by Urban Dictionary and stops working about a week after the step runs, so download or play it in the same workflow rather than storing it for later.

Inputs

TermtermtextRequired: The slang term to look up. A phrase works as well as a single word, and capitals do not matter: Urban Dictionary matches either way and answers with the spelling its authors used.
Pagepagenumber: Which page of 10 to fetch. Leave this empty for the first page, which holds the top definitions. Asking past the last page returns nothing rather than failing.From 1 to 1000.
Most rows to returnmax_resultsnumber: The most rows to return. Leave this empty to get all of them. The answer always reports the total, so you can see when there were more.From 1 to 500.

Outputs

audio_urltext
countnumber
foundtrue/false
image_urltext
medialist
pagenumber
termtext
totalnumber

Example output

{
  "audio_url": "https://cdn.urbdic.com/audio/tts/4/c/4c1202-rizz.mp3?Expires=1788469939",
  "count": 1,
  "found": true,
  "image_url": "https://udimg.com/v1/social/twitter.webp?word=Rizz",
  "media": [
    {
      "audio_url": "https://cdn.urbdic.com/audio/tts/4/c/4c1202-rizz.mp3?Expires=1788469939",
      "author": "bro got no rizz",
      "definition": "Another word for spitting game/how good you are with pulling people.",
      "definition_id": 17115763,
      "image_url": "https://udimg.com/v1/social/twitter.webp?word=Rizz",
      "permalink": "https://www.urbandictionary.com/define.php?term=Rizz&defid=17115763",
      "term": "Rizz"
    }
  ],
  "page": 1,
  "term": "Rizz",
  "total": 10
}

List the other slang a term's definitions link to, ranked by how many of them mention it. Urban Dictionary's authors mark related terms inside their own text and the site turns each one into a link, so this is how a workflow walks from one term out to the slang around it: 'rizz' leads to 'game' and 'charisma'. Feed a term back into 'Define a term' to keep going.

Inputs

TermtermtextRequired: The slang term to look up. A phrase works as well as a single word, and capitals do not matter: Urban Dictionary matches either way and answers with the spelling its authors used.
Pagepagenumber: Which page of 10 to fetch. Leave this empty for the first page, which holds the top definitions. Asking past the last page returns nothing rather than failing.From 1 to 1000.
Most rows to returnmax_resultsnumber: The most rows to return. Leave this empty to get all of them. The answer always reports the total, so you can see when there were more.From 1 to 500.

Outputs

countnumber
definitions_readnumber
foundtrue/false
pagenumber
related_termslist
termtext
totalnumber

Example output

{
  "count": 3,
  "definitions_read": 10,
  "found": true,
  "page": 1,
  "related_terms": [
    {
      "definitions_linking_to_it": 3,
      "term": "game"
    },
    {
      "definitions_linking_to_it": 2,
      "term": "charisma"
    },
    {
      "definitions_linking_to_it": 1,
      "term": "charm"
    }
  ],
  "term": "Rizz",
  "total": 47
}

Get a term's top definition

Get only the top definition of a term, as flat fields, so a message can read the definition, the example and the link straight off the step without picking a row out of a list. The top definition is the one Urban Dictionary itself ranks first, which is what the website shows. A term nobody has defined answers with empty fields rather than failing.

Inputs

TermtermtextRequired: The slang term to look up. A phrase works as well as a single word, and capitals do not matter: Urban Dictionary matches either way and answers with the spelling its authors used.

Outputs

audio_urltext
authortext
definitiontext
definition_count_on_pagenumber
definition_idnumber
definition_markuptext
exampletext
example_markuptext
foundtrue/false
image_urltext
linked_termslist
permalinktext
termtext
written_datetext
written_ontext

Example output

{
  "audio_url": "https://cdn.urbdic.com/audio/tts/4/c/4c1202-rizz.mp3?Expires=1788469939",
  "author": "bro got no rizz",
  "definition": "Another word for spitting game/how good you are with pulling people.",
  "definition_count_on_page": 10,
  "definition_id": 17115763,
  "definition_markup": "Another word for spitting [game]/how good [you are] with pulling people.",
  "example": "Damn, that guy has no rizz.",
  "example_markup": "Damn, that guy has no [rizz].",
  "found": true,
  "image_url": "https://udimg.com/v1/social/twitter.webp?word=Rizz",
  "linked_terms": [
    "game",
    "you are"
  ],
  "permalink": "https://www.urbandictionary.com/define.php?term=Rizz&defid=17115763",
  "term": "Rizz",
  "written_date": "2022-03-31",
  "written_on": "2022-03-31T10:36:17.000Z"
}

Get a term's usage examples

List the example sentences Urban Dictionary holds for a term, one per definition, beside the definition each one illustrates. Every definition is submitted with an example of the term in use, which is what shows how it is actually said rather than what it means. Definitions submitted without one are left out rather than returned blank.

Inputs

TermtermtextRequired: The slang term to look up. A phrase works as well as a single word, and capitals do not matter: Urban Dictionary matches either way and answers with the spelling its authors used.
Pagepagenumber: Which page of 10 to fetch. Leave this empty for the first page, which holds the top definitions. Asking past the last page returns nothing rather than failing.From 1 to 1000.
Ordersorttext: What order to return the definitions in. Leave this empty to keep Urban Dictionary's own ranking, which puts the definition the site shows first at the top.One of: relevance (Top rated first: the order Urban Dictionary itself ranks them in), newest (Newest first: most recently written), oldest (Oldest first: the original definitions). Default: relevance.
Written on or afterwritten_afterdate: Keep only definitions submitted on or after this day. Leave this empty for no earliest date. Useful for telling new slang from a meaning a term has had since 2005.
Written on or beforewritten_beforedate: Keep only definitions submitted on or before this day. Leave this empty for no latest date.
Most rows to returnmax_resultsnumber: The most rows to return. Leave this empty to get all of them. The answer always reports the total, so you can see when there were more.From 1 to 500.

Outputs

countnumber
exampleslist
foundtrue/false
matchednumber
on_pagenumber
pagenumber
termtext

Example output

{
  "count": 2,
  "examples": [
    {
      "author": "bro got no rizz",
      "definition": "Another word for spitting game/how good you are with pulling people.",
      "definition_id": 17115763,
      "example": "Damn, that guy has no rizz.",
      "example_markup": "Damn, that guy has no [rizz].",
      "permalink": "https://www.urbandictionary.com/define.php?term=Rizz&defid=17115763",
      "term": "Rizz",
      "written_date": "2022-03-31",
      "written_on": "2022-03-31T10:36:17.000Z"
    },
    {
      "author": "unspoken rizz",
      "definition": "Short for charisma. The ability to charm someone.",
      "definition_id": 17233871,
      "example": "He pulled her with pure rizz.",
      "example_markup": "He pulled her with pure rizz.",
      "permalink": "https://www.urbandictionary.com/define.php?term=Rizz&defid=17233871",
      "term": "Rizz",
      "written_date": "2022-09-04",
      "written_on": "2022-09-04T00:11:31.000Z"
    }
  ],
  "found": true,
  "matched": 10,
  "on_page": 10,
  "page": 1,
  "term": "Rizz"
}

Get one definition by its link

Fetch exactly one definition, by the link or the id that identifies it. This is how a workflow comes back to the definition an earlier step saw, rather than re-running a search whose ranking may have shifted underneath it. A link that points at nothing fails the step, because a wrong id is a mistake rather than an answer.

Inputs

Definitiondefinition_idtextRequired: Which definition to fetch. Paste its Urban Dictionary link, or give the id on its own: both work. Every action that returns definitions reports the id and the link, so this is usually chained in from an earlier step.

Outputs

audio_urltext
authortext
definitiontext
definition_idnumber
definition_markuptext
exampletext
example_markuptext
foundtrue/false
image_urltext
linked_termslist
permalinktext
termtext
written_datetext
written_ontext

Example output

{
  "audio_url": "https://cdn.urbdic.com/audio/tts/4/4/442e06-wat.mp3?Expires=1788469674",
  "author": "watwat",
  "definition": "The only proper response to something that makes absolutely no sense.",
  "definition_id": 3322419,
  "definition_markup": "The only [proper] response to [something] that makes absolutely no [sense].",
  "example": "1: I accidentially a whole coke bottle\n2: wat",
  "example_markup": "1: I accidentially a whole coke bottle\n2: wat",
  "found": true,
  "image_url": "https://udimg.com/v1/social/twitter.webp?word=wat",
  "linked_terms": [
    "proper",
    "something",
    "sense"
  ],
  "permalink": "https://www.urbandictionary.com/define.php?term=wat&defid=3322419",
  "term": "wat",
  "written_date": "2008-10-18",
  "written_on": "2008-10-18T00:00:00.000Z"
}

Get random definitions

Get 10 random definitions from anywhere in Urban Dictionary, different on every run, which is what a slang-of-the-day post or a word-game workflow runs on. The terms come back as their own list beside the full definitions, so a step that only needs the words does not have to walk the rows. Page reaches another random handful rather than the next one in an order: there is no order here to be next in.

Inputs

Pagepagenumber: Which page of 10 to fetch. Leave this empty for the first page, which holds the top definitions. Asking past the last page returns nothing rather than failing.From 1 to 1000.
Ordersorttext: What order to return the definitions in. Leave this empty to keep Urban Dictionary's own ranking, which puts the definition the site shows first at the top.One of: relevance (Top rated first: the order Urban Dictionary itself ranks them in), newest (Newest first: most recently written), oldest (Oldest first: the original definitions). Default: relevance.
Most rows to returnmax_resultsnumber: The most rows to return. Leave this empty to get all of them. The answer always reports the total, so you can see when there were more.From 1 to 500.

Outputs

countnumber
definitionslist
pagenumber
termslist
top_definitiontext
top_termtext
totalnumber

Example output

{
  "count": 2,
  "definitions": [
    {
      "audio_url": "https://cdn.urbdic.com/audio/tts/4/4/442e06-wat.mp3?Expires=1788469674",
      "author": "watwat",
      "definition": "The only proper response to something that makes absolutely no sense.",
      "definition_id": 3322419,
      "definition_markup": "The only [proper] response to [something] that makes absolutely no [sense].",
      "example": "1: I accidentially a whole coke bottle\n2: wat",
      "example_markup": "1: I accidentially a whole coke bottle\n2: wat",
      "image_url": "https://udimg.com/v1/social/twitter.webp?word=wat",
      "linked_terms": [
        "proper",
        "something",
        "sense"
      ],
      "permalink": "https://www.urbandictionary.com/define.php?term=wat&defid=3322419",
      "term": "wat",
      "written_date": "2008-10-18",
      "written_on": "2008-10-18T00:00:00.000Z"
    },
    {
      "audio_url": "https://cdn.urbdic.com/audio/tts/4/c/4c1202-rizz.mp3?Expires=1788469939",
      "author": "bro got no rizz",
      "definition": "Another word for spitting game/how good you are with pulling people.",
      "definition_id": 17115763,
      "definition_markup": "Another word for spitting [game]/how good [you are] with pulling people.",
      "example": "Damn, that guy has no rizz.",
      "example_markup": "Damn, that guy has no [rizz].",
      "image_url": "https://udimg.com/v1/social/twitter.webp?word=Rizz",
      "linked_terms": [
        "game",
        "you are"
      ],
      "permalink": "https://www.urbandictionary.com/define.php?term=Rizz&defid=17115763",
      "term": "Rizz",
      "written_date": "2022-03-31",
      "written_on": "2022-03-31T10:36:17.000Z"
    }
  ],
  "page": 1,
  "terms": [
    "wat",
    "Rizz"
  ],
  "top_definition": "The only proper response to something that makes absolutely no sense.",
  "top_term": "wat",
  "total": 10
}

Get the words of the day

Get the terms Urban Dictionary has picked as its word of the day, 10 per page, each with the day it was featured and the definition that went with it. This is what a daily digest, a newsletter section or a team channel post runs on. The featured day is the site's own label ('January 7') and carries no year; the date the definition itself was written is beside it as a real date.

Inputs

Pagepagenumber: Which page of 10 to fetch. Leave this empty for the first page, which holds the top definitions. Asking past the last page returns nothing rather than failing.From 1 to 1000.
Most rows to returnmax_resultsnumber: The most rows to return. Leave this empty to get all of them. The answer always reports the total, so you can see when there were more.From 1 to 500.

Outputs

countnumber
pagenumber
termslist
top_definitiontext
top_termtext
totalnumber
wordslist

Example output

{
  "count": 1,
  "page": 1,
  "terms": [
    "age gate"
  ],
  "top_definition": "An absolutely foolproof way to keep minors from viewing content deemed \"too mature\" for them to watch.",
  "top_term": "age gate",
  "total": 10,
  "words": [
    {
      "audio_url": "https://cdn.urbdic.com/audio/tts/8/1/81a0c2-age-gate.mp3?Expires=1788469674",
      "author": "Banja",
      "definition": "An absolutely foolproof way to keep minors from viewing content deemed \"too mature\" for them to watch.",
      "definition_id": 5494744,
      "definition_markup": "An absolutely foolproof way to keep minors from viewing [content] deemed \"too [mature]\" for them to [watch].",
      "example": "I ran into an age gate, so I put in my real birthday.",
      "example_markup": "I ran into an age gate, so I put in my real [birthday].",
      "featured_on": "January 7",
      "image_url": "https://udimg.com/v1/social/twitter.webp?word=age+gate",
      "linked_terms": [
        "content",
        "mature",
        "watch",
        "birthday"
      ],
      "permalink": "https://www.urbandictionary.com/define.php?term=age%20gate&defid=5494744",
      "term": "age gate",
      "written_date": "2011-01-07",
      "written_on": "2011-01-07T00:00:00.000Z"
    }
  ]
}

Suggest terms for a prefix

Get up to 10 real Urban Dictionary headwords that start with what has been typed so far, as a plain list of words. This is the 'did you mean' step: it turns a half-remembered or misspelled term into ones the site actually holds, and it also answers whether the prefix is itself a defined term, so a spell-check needs only the one request.

Inputs

TermtermtextRequired: The slang term to look up. A phrase works as well as a single word, and capitals do not matter: Urban Dictionary matches either way and answers with the spelling its authors used.
Most rows to returnmax_resultsnumber: The most rows to return. Leave this empty to get all of them. The answer always reports the total, so you can see when there were more.From 1 to 500.

Outputs

countnumber
foundtrue/false
is_a_termtrue/false
suggestionslist
termtext
totalnumber

Example output

{
  "count": 5,
  "found": true,
  "is_a_term": true,
  "suggestions": [
    "watermelon sugar",
    "water",
    "watermelon",
    "Wattpad",
    "wat"
  ],
  "term": "wat",
  "total": 10
}

Suggest terms with previews

The same suggestions as 'Suggest terms for a prefix', but each one carries the start of its top definition. That is enough to tell two similar-looking terms apart, or to pick the one that is actually meant, without spending a lookup on each of them. The preview is cut off mid-word by Urban Dictionary at around a hundred characters.

Inputs

TermtermtextRequired: The slang term to look up. A phrase works as well as a single word, and capitals do not matter: Urban Dictionary matches either way and answers with the spelling its authors used.
Most rows to returnmax_resultsnumber: The most rows to return. Leave this empty to get all of them. The answer always reports the total, so you can see when there were more.From 1 to 500.

Outputs

countnumber
foundtrue/false
suggestionslist
termtext
termslist
totalnumber

Example output

{
  "count": 2,
  "found": true,
  "suggestions": [
    {
      "preview": "The name for a type of street heroine that originated in Southern Georgia in the late 1990's",
      "term": "watermelon sugar"
    },
    {
      "preview": "Liquid substance made famous by NOLF2.",
      "term": "water"
    }
  ],
  "term": "wat",
  "terms": [
    "watermelon sugar",
    "water"
  ],
  "total": 10
}

ActionsCopy Anchor Link

Browse all of a term's definitionsCopy Anchor Link

Inputs

Outputs

Check whether a term is definedCopy Anchor Link

Inputs

Outputs

Define a termCopy Anchor Link

Inputs

Outputs

Define several termsCopy Anchor Link

Inputs

Outputs

Get a term's audio and imagesCopy Anchor Link

Inputs

Outputs

Get a term's related slangCopy Anchor Link

Inputs

Outputs

Get a term's top definitionCopy Anchor Link

Inputs

Outputs

Get a term's usage examplesCopy Anchor Link

Inputs

Outputs

Get one definition by its linkCopy Anchor Link

Inputs

Outputs

Get random definitionsCopy Anchor Link

Inputs

Outputs

Get the words of the dayCopy Anchor Link

Inputs

Outputs

Suggest terms for a prefixCopy Anchor Link

Inputs

Outputs

Suggest terms with previewsCopy Anchor Link

Inputs

Outputs

On this page

Actions

Browse all of a term's definitions

Check whether a term is defined

Define a term

Define several terms

Get a term's audio and images

Get a term's related slang

Get a term's top definition

Get a term's usage examples

Get one definition by its link

Get random definitions

Get the words of the day

Suggest terms for a prefix

Suggest terms with previews