Urban Dictionary Scraper

Urban Dictionary Scraper is an Apify actor for extracting definitions from from urbandictionary.com. It gives you access to the huge community based list of definitions for slang, meme, or many different things that is ongoing around the Web in structured form. It is build on top of Apify SDK and you can run it both on Apify platform and locally!

• Input
• Output
• Compute units consumption
• Extend output function
• Send results to Notion, Todoist and more

Input Parameters

Field	Type	Description	Default value
startUrls	array	Urban Dictionary full search URLs as a String Array	[]
keywords	array	List of keywords that you want to search on Urban Dictionary	[]
maxItems	number	Maximum number of items that you want to receive as output	Infinity
customMapFunction	string	Function that takes each of the output rows as argument and returns data that will be mapped, changed formatting, of the each rows. More information in Custom map function
outputConnector	string	Optional MCP connector to deliver the results to. See the MCP connectors section below.	null
deliverTarget	string	Where the connector writes: a page or database URL or ID (Notion example: https://www.notion.so/My-Posts-24f8a1b2c3d44e5f8a9b0c1d2e3f4a5b). Some services need none.	null
deliverMode	string	perPost writes one record per item, summary one roll-up per run.	perPost
deliverMaxItems	number	Optional cap on how many records perPost delivers. Ignored in summary.	null

🆓 Demo Mode & Free Users

Users on the Free Plan can use the actor only in Demo Mode. Free users can run the actor up to 5 times per month, with each run capped at a maximum of 10 items — just enough to test it out. To use this actor without limitations, subscribe to a paid plan on Apify. Subscribe here.

Compute Unit Consumption

The average consumption is 0.003 to 0.005 per 100 results. It is extremely fast and optimized for the public usage.

Output

Output is stored in a dataset. Each item is information about post related with a keyword.

{
	"definition": "[An abbreviation] that stands for 'laugh out loud' to you, but 'lots of [love'] for [your mom].",
	"url": "http://lol.urbanup.com/11482563",
	"numberOfThumbsUp": 5528,
	"author": "dyhtgrew",
	"word": "lol",
	"id": 11482563,
	"createdAt": "2017-04-26T02:41:29.898Z",
	"example": "Mom: [Grandma] just [died]. LOL\r\nSon: Mom [what the fuck]?",
	"numberOfThumbsDown": 714
}

Custom map function

You can use this function to change the output of each of the rows that you will get from this actor. This function gets each of the rows on the output as an argument so you can change the formatting, pick which attributes you want to get as the output. The output from this function will be converted into the format you will return. This function is not intended for filtering, please don't use it for filtering purposes or you will get banned automatically.

The return value of this function has to be an object!

You can return fields to achive 3 different things:

• Add a new field - Return object with a field that is not in the default output
• Change a field - Return an existing field with a new value
• Remove a field - Return an existing field with a value undefined

(object) => {
    return {
        author: object.author + " user",
        id: `${object.id}`,
    }
}

This example will change the output in the following way;

{
  "author": "dyhtgrew user"
  "id": "11482563"
}

Send Results to Notion, Todoist and More (MCP Connectors)

The Urban Dictionary Scraper can deliver its results straight into the tools you already use, through Apify MCP Connectors.

1. Authorize a connector (Notion, Todoist, or any service whose MCP server offers non-destructive write tools) once in Console → Settings → API & Integrations → MCP connectors.
2. Pick it in the Send results to Notion, Todoist, … field.
3. Fill in where and how to write:
   • Destination target: the page or database URL or ID (Notion example: https://www.notion.so/My-Posts-24f8a1b2c3d44e5f8a9b0c1d2e3f4a5b). Share it with your connector first through Notion's ••• → Connections menu. Some services need no target.
   • Write mode: perPost writes one record per definition; summary writes a single roll-up for the run.
   • Max records to deliver (optional): a cap on how many records perPost delivers.

Notion: point the target at a Notion page and the Actor creates a database with one typed column per field (URL, number, date, text). An existing database gets its matching columns filled by name. The connector can't add columns to it, so an empty database receives only titles and the rest of each record goes to the row's page body. Each definition field gets its own column: numberOfThumbsUp and numberOfThumbsDown as numbers, url as a link, and word, definition and example as text. Fields without a column go to the row's page body, so nothing is lost.

Your credentials stay with you: the Actor writes only through your own connector and only uses non-destructive write tools, so it can't delete or overwrite anything. Delivery runs after the scrape and is best-effort. If it fails, the run still finishes normally with all results in the dataset, and the run log says what went wrong. If the run is close to its timeout, delivery stops early so the run still succeeds, and the log says how many records were delivered.

Urban Dictionary Scraper Export

During the run, the actor stores results into a dataset. Each item is a separate item in the dataset.

You can manage the results in any language (Python, PHP, Node JS/NPM). See the FAQ or our API reference to learn more about getting results from this Urban Dictionary actor.

Contact

If you need any sort of support, please send an email to apidojo10@gmail.com. You name it, we get it.

🈴 Other Actors you might want to check

• Twitter Scraper Lite
• Twitter List Scraper
• Twitter User Scraper
• TikTok Comment Scraper
• TikTok User Scraper