# Urban Dictionary Definitions Scraper (`parseforge/urbandictionary-definitions-scraper`) Actor Scrape Urban Dictionary slang definitions: word, definition, example, author, thumbs up, thumbs down, date, defid, and permalink. Track new and trending internet slang, memes, and youth vocabulary. Export to JSON, CSV, or Excel for cultural research, NLP datasets, and trend monitoring. - **URL**: https://apify.com/parseforge/urbandictionary-definitions-scraper.md - **Developed by:** [ParseForge](https://apify.com/parseforge) (community) - **Categories:** Social media, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $9.00 / 1,000 result items This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true) ## ๐Ÿ—ฃ๏ธ Urban Dictionary Definitions Scraper > ๐Ÿš€ **Export crowd-sourced slang in seconds.** Pull definitions, examples, votes, and audio links for any term, a stream of random entries, or the curated word of the day. No API key, no login, no rate-limit headaches. > ๐Ÿ•’ **Last updated:** 2026-05-26 ยท **๐Ÿ“Š 14 fields** per record ยท **๐Ÿ—ฃ๏ธ 12M+ entries** ยท **๐ŸŒ global English slang** ยท **๐ŸŽฒ 3 collection modes** The **Urban Dictionary Definitions Scraper** taps the same live feed that powers the urbandictionary.com homepage and returns **14 fields per record**, including the definition, example sentence, author handle, community upvotes and downvotes, score, an autogenerated card image, a text-to-speech audio link, and a permalink. Urban Dictionary is the largest open repository of contemporary slang, with **12M+ user-submitted entries** spanning street talk, gaming jargon, internet acronyms, regional expressions, and brand-new coinages. The catalog updates continuously as the community votes and contributes. This Actor exposes three workflows in one input form: **define** a list of specific terms, pull a **random** sample for trend mining, or grab the **Word of the Day** feed for daily content pipelines. All three modes return identical record shapes so your downstream code stays simple. | ๐ŸŽฏ Target Audience | ๐Ÿ’ก Primary Use Cases | |---|---| | Linguists, social-media tools, content marketers, NLP researchers, brand-safety teams, dictionary apps, journalists | Slang dictionaries, brand monitoring, content moderation training, NLP labeling, trend research, conversational AI | --- ### ๐Ÿ“‹ What the Urban Dictionary Scraper does Three collection workflows in a single run: - ๐Ÿ” **Define mode.** Look up an exact list of terms and pull every competing definition ranked by community votes. - ๐ŸŽฒ **Random mode.** Stream unrelated definitions for sampling, training data, or content discovery. - ๐Ÿ“… **Word of the Day mode.** Fetch the curated daily feed for editorial pipelines and slack-bots. Each record includes the slang word, the full definition, a usage example, the author's display name, upvotes, downvotes, a computed net score, the autogenerated social card image, the text-to-speech audio URL, the canonical permalink, and the original posting date. > ๐Ÿ’ก **Why it matters:** slang moves fast, and a phrase that was a meme last week can be a brand-safety risk tomorrow. Building your own crawler means parsing dynamic pages, handling permalinks, and refreshing every few hours. This Actor returns the structured data on demand, so your dictionary, moderator, or marketing tool stays on the pulse. --- ### ๐ŸŽฌ Full Demo _๐Ÿšง Coming soon: a 3-minute walkthrough showing how to go from sign-up to a downloaded dataset._ --- ### โš™๏ธ Input
InputTypeDefaultBehavior
maxItemsinteger10Records to return. Free plan caps at 10, paid plan at 1,000,000.
modeenum"define"One of define, random, wordOfTheDay.
termsarray["yeet","cap","fire","slay","vibes"]Slang words to look up in define mode. Each term returns multiple ranked definitions.
minThumbsUpinteger0Drop any definition with fewer upvotes than this threshold.
**Example: top definitions for five popular slang words.** ```json { "maxItems": 25, "mode": "define", "terms": ["yeet", "cap", "fire", "slay", "vibes"] } ```` **Example: today's curated Word of the Day entries.** ```json { "maxItems": 10, "mode": "wordOfTheDay" } ``` > โš ๏ธ **Good to Know:** Urban Dictionary is community-moderated and content can be vulgar, satirical, or offensive. Apply a profanity filter or moderator review before surfacing entries directly to end-users. The Word of the Day feed is editorially curated and safer for default display. *** ### ๐Ÿ“Š Output Each record contains **14 fields**. Download the dataset as CSV, Excel, JSON, or XML. #### ๐Ÿงพ Schema | Field | Type | Example | |---|---|---| | ๐Ÿ–ผ๏ธ `imageUrl` | string | `"https://udimg.com/v1/social/twitter.webp?word=Yeet&..."` | | ๐Ÿ†” `defid` | number | `12339851` | | ๐Ÿ—ฃ๏ธ `word` | string | `"Yeet"` | | โœ๏ธ `author` | string | `"Le anonymous"` | | ๐Ÿ“– `definition` | string | `"To discard an item at a high velocity"` | | ๐Ÿ’ฌ `example` | string | `"Alex (while throwing the can): YEET!"` | | ๐Ÿ‘ `thumbsUp` | number | `1842` | | ๐Ÿ‘Ž `thumbsDown` | number | `233` | | ๐Ÿ“Š `score` | number | `1609` | | ๐Ÿ”Š `audioUrl` | string | null | `"https://cdn.urbdic.com/audio/tts/.../yeet.mp3"` | | ๐ŸŽต `soundUrls` | array | `["https://cdn.urbdic.com/audio/tts/.../yeet.mp3"]` | | ๐Ÿ”— `permalink` | string | `"https://www.urbandictionary.com/define.php?term=Yeet&defid=12339851"` | | ๐Ÿ“… `wordOfTheDayDate` | string | null | `"2026-05-25"` | | ๐Ÿ•’ `writtenOn` | ISO 8601 | `"2018-04-22T00:00:00.000Z"` | | ๐Ÿ•’ `scrapedAt` | ISO 8601 | `"2026-05-26T00:08:47.438Z"` | #### ๐Ÿ“ฆ Sample records
๐Ÿ—ฃ๏ธ Define mode: top definition for "yeet" ```json { "defid": 12339851, "word": "Yeet", "author": "Le anonymous", "definition": "To discard an item at a high velocity", "example": "Alex finishes his soda and proceeds to yeet his empty can into a trash bin\n\nAlex (while throwing the can): YEET!", "thumbsUp": 1842, "thumbsDown": 233, "score": 1609, "audioUrl": "https://cdn.urbdic.com/audio/tts/f/4/f499-yeet.mp3", "soundUrls": ["https://cdn.urbdic.com/audio/tts/f/4/f499-yeet.mp3"], "permalink": "https://www.urbandictionary.com/define.php?term=Yeet&defid=12339851", "writtenOn": "2018-04-22T00:00:00.000Z", "scrapedAt": "2026-05-26T00:08:47.438Z" } ```
๐ŸŽฒ Random mode: an arbitrary community entry ```json { "defid": 9876543, "word": "spilling tea", "author": "TruthSayer42", "definition": "Sharing the latest gossip or revealing the inside story on a situation.", "example": "Sit down honey, I'm about to spill the tea on what happened at the party.", "thumbsUp": 412, "thumbsDown": 18, "score": 394, "permalink": "https://www.urbandictionary.com/define.php?term=spilling+tea&defid=9876543", "writtenOn": "2019-08-14T00:00:00.000Z", "scrapedAt": "2026-05-26T00:08:47.501Z" } ```
๐Ÿ“… Word of the Day: curated daily feed ```json { "defid": 11223344, "word": "Stealthie", "author": "frontporch", "definition": "When you're holding up your phone and making faces at it, as though you are taking a selfie, but you're really taking a picture of someone across from you.", "example": "FRIEND A: Did you just take a stealthie of me?", "thumbsUp": 256, "thumbsDown": 12, "score": 244, "wordOfTheDayDate": "2026-05-25", "permalink": "https://www.urbandictionary.com/define.php?term=Stealthie", "writtenOn": "2020-03-11T00:00:00.000Z", "scrapedAt": "2026-05-26T00:08:47.612Z" } ```
*** ### โœจ Why choose this Actor | | Capability | |---|---| | ๐ŸŒ | **Massive catalog.** 12M+ user-submitted slang entries spanning two decades of internet culture. | | ๐ŸŽฏ | **Three modes in one Actor.** Define specific terms, pull random samples, or grab the curated daily feed. | | ๐Ÿ“Š | **Quality signal built in.** Upvotes, downvotes, and a computed score let you filter out joke definitions. | | ๐Ÿ–ผ๏ธ | **Visual and audio extras.** Each entry ships with an autogenerated card image and a text-to-speech audio link. | | โšก | **Fast.** 5 definitions in under a second, hundreds per minute. | | ๐Ÿ” | **Always fresh.** Every run hits the live feed, so your dataset reflects today's slang. | | ๐Ÿšซ | **No authentication.** Public crowd-sourced data, no login or API key required. | > ๐Ÿ“Š Slang is one of the fastest-moving signals in language. Brands, moderators, and content tools that miss new coinages get caught off-guard. *** ### ๐Ÿ“ˆ How it compares to alternatives | Approach | Cost | Coverage | Refresh | Filters | Setup | |---|---|---|---|---|---| | **โญ Urban Dictionary Scraper** *(this Actor)* | $5 free credit, then pay-per-use | **12M+** entries | **Live per run** | term, random, word of the day, min upvotes | โšก 2 min | | Manual website browsing | Free | Limited by clicks | Manual | None | ๐Ÿข Hours | | Building your own crawler | Engineering time | Full | Custom | Custom | โณ Days | | Static slang lists | Free or cheap | Frozen in time | Never | None | ๐Ÿ•’ Variable | Pick this Actor when you want live community data, ready-to-use scoring, and zero pipeline maintenance. *** ### ๐Ÿš€ How to use 1. ๐Ÿ“ **Sign up.** [Create a free account with $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) (takes 2 minutes). 2. ๐ŸŒ **Open the Actor.** Go to the Urban Dictionary Definitions Scraper page on the Apify Store. 3. ๐ŸŽฏ **Set input.** Pick a mode, drop in your terms (or leave it random), and set `maxItems`. 4. ๐Ÿš€ **Run it.** Click **Start** and let the Actor collect your data. 5. ๐Ÿ“ฅ **Download.** Grab your results in the **Dataset** tab as CSV, Excel, JSON, or XML. > โฑ๏ธ Total time from signup to downloaded dataset: **3-5 minutes.** No coding required. *** ### ๐Ÿ’ผ Business use cases
#### ๐Ÿ›ก๏ธ Content Moderation & Brand Safety - Train profanity classifiers with current slang - Flag ambiguous brand names against community definitions - Build moderation glossaries that stay current - Audit user-generated content for emerging coded language #### ๐Ÿ“ฑ Dictionary Apps & Chatbots - Power slang lookups inside translation apps - Add a "what does this mean" button to messengers - Voice assistants that decode TikTok-era vocabulary - Glossary panels for parents and educators
#### ๐Ÿ“ฐ Marketing & Trend Research - Spot rising slang for ad copy and social campaigns - Track Gen-Z vocabulary shifts quarter over quarter - Build editorial calendars around Word of the Day - Compare brand mentions against community definitions #### ๐Ÿง  NLP & Conversational AI - Augment training sets with informal English - Improve named-entity recognition on social text - Bootstrap intent classifiers with real-world examples - Evaluate LLM understanding of contemporary slang
*** ### ๐Ÿ”Œ Automating Urban Dictionary Scraper Control the scraper programmatically for scheduled runs and pipeline integrations: - ๐ŸŸข **Node.js.** Install the `apify-client` NPM package. - ๐Ÿ **Python.** Use the `apify-client` PyPI package. - ๐Ÿ“š See the [Apify API documentation](https://docs.apify.com/api/v2) for full details. The [Apify Schedules feature](https://docs.apify.com/platform/schedules) lets you trigger this Actor on any cron interval. Daily Word of the Day pulls or hourly term refreshes keep downstream dictionaries and Slack bots in sync automatically. *** ### ๐ŸŒŸ Beyond business use cases Data like this powers more than commercial workflows. The same structured records support research, education, civic projects, and personal initiatives.
#### ๐ŸŽ“ Research and academia - Sociolinguistics studies of slang propagation - Computational humor and meme research datasets - Comparative dictionaries of informal English - Internet-culture archives for digital humanities #### ๐ŸŽจ Personal and creative - Trivia bots and word-of-the-day Slack apps - Vocabulary expansion games for language learners - Generative art that visualizes definitions - Personal slang journals and TikTok content prompts
#### ๐Ÿค Non-profit and civic - Educator resources for understanding student vernacular - Translator references for crisis hotlines and youth services - Civic dashboards tracking emerging coded language - Volunteer moderator toolkits for community forums #### ๐Ÿงช Experimentation - Fine-tune small LLMs on contemporary slang - Prototype voice assistants with real Gen-Z input - Benchmark sentiment models on informal text - Test image-card generators with definition prompts
*** ### ๐Ÿค– Ask an AI assistant about this scraper Open a ready-to-send prompt about this ParseForge actor in the AI of your choice: - ๐Ÿ’ฌ [**ChatGPT**](https://chat.openai.com/?q=How%20do%20I%20use%20the%20Urban%20Dictionary%20Definitions%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - ๐Ÿง  [**Claude**](https://claude.ai/new?q=How%20do%20I%20use%20the%20Urban%20Dictionary%20Definitions%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - ๐Ÿ” [**Perplexity**](https://perplexity.ai/search?q=How%20do%20I%20use%20the%20Urban%20Dictionary%20Definitions%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - ๐Ÿ…’ [**Copilot**](https://copilot.microsoft.com/?q=How%20do%20I%20use%20the%20Urban%20Dictionary%20Definitions%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) *** ### โ“ Frequently Asked Questions #### ๐Ÿงฉ How does it work? Pick a mode, list your terms (or leave them empty for random or daily mode), click Start, and the Actor fetches the live community feed and emits a clean structured record per definition. No browser automation, no captchas, no setup. #### ๐Ÿ“ How accurate are the votes? Vote counts reflect the current community state at the moment of the run. Older entries tend to have larger vote totals, while recent submissions may still be accumulating signal. Use the `score` field (upvotes minus downvotes) as a quality proxy. #### ๐Ÿ” How often is the data refreshed? The Urban Dictionary catalog updates continuously as users submit and vote. Every run of this Actor fetches the latest data, so your dataset reflects current entries as of run time. #### ๐ŸŽฒ Can I use it for trend research? Yes. Run the random mode on a schedule to sample new entries, or pull the Word of the Day feed daily to track curator picks. Both modes work well as inputs to NLP pipelines. #### ๐Ÿ›ก๏ธ Will I get explicit content? Maybe. Community submissions can be vulgar, satirical, or offensive. Apply a profanity filter or moderator review before surfacing entries directly to end-users. The `minThumbsUp` filter helps drop low-quality joke entries. #### โฐ Can I schedule regular runs? Yes. Use Apify Schedules to run this Actor hourly, daily, or weekly and keep a downstream dictionary, Slack bot, or moderation feed in sync. #### โš–๏ธ Is this data legal to use? Urban Dictionary content is publicly accessible and the Actor only collects what any visitor can read. Review the source's terms for your specific use case, especially for commercial redistribution. #### ๐Ÿ’ผ Can I use this data commercially? Yes, with care. The raw definitions and metadata are public, but redistribution of large excerpts may require attribution or rights review depending on your product. Consult counsel for high-volume commercial use. #### ๐Ÿ’ณ Do I need a paid Apify plan to use this Actor? No. The free Apify plan is enough for testing and small runs (10 records per run). A paid plan lifts the limit and gives you access to scheduling, higher concurrency, and larger datasets. #### ๐Ÿ” What happens if a run fails or gets interrupted? Apify automatically retries transient errors. If a run still fails, you can inspect the log in the Runs tab, fix the input, and re-run. Partial datasets from failed runs are preserved so you never lose progress. #### ๐Ÿ†˜ What if I need help? Our support team is here to help. Contact us through the Apify platform or use the Tally form linked below. *** ### ๐Ÿ”Œ Integrate with any app Urban Dictionary Definitions Scraper connects to any cloud service via [Apify integrations](https://apify.com/integrations): - [**Make**](https://docs.apify.com/platform/integrations/make) - Automate multi-step workflows - [**Zapier**](https://docs.apify.com/platform/integrations/zapier) - Connect with 5,000+ apps - [**Slack**](https://docs.apify.com/platform/integrations/slack) - Get run notifications in your channels - [**Airbyte**](https://docs.apify.com/platform/integrations/airbyte) - Pipe slang data into your warehouse - [**GitHub**](https://docs.apify.com/platform/integrations/github) - Trigger runs from commits and releases - [**Google Drive**](https://docs.apify.com/platform/integrations/drive) - Export datasets straight to Sheets You can also use webhooks to trigger downstream actions when a run finishes. Push fresh slang into your dictionary backend, or alert your team in Slack with the daily Word of the Day. *** ### ๐Ÿ”— Recommended Actors - [**๐Ÿ“– Wikipedia REST Summaries Scraper**](https://apify.com/parseforge/wikipedia-rest-summaries-scraper) - Extract Wikipedia page summaries and metadata - [**๐Ÿ“œ Wikiquote Summaries Scraper**](https://apify.com/parseforge/wikiquote-summaries-scraper) - Quote-page summaries and parsed quotes from Wikiquote - [**๐Ÿ›๏ธ Wikidata Entity Search Scraper**](https://apify.com/parseforge/wikidata-entity-search-scraper) - Resolve any string to a structured Wikidata entity - [**๐Ÿ“š arXiv Preprint Scraper**](https://apify.com/parseforge/arxiv-scraper) - Open-access research papers across every science domain - [**๐ŸŒ Wikipedia Pageviews Scraper**](https://apify.com/parseforge/wikipedia-pageviews-scraper) - Time-series traffic data for any Wikipedia article > ๐Ÿ’ก **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge) for more reference-data scrapers. *** **๐Ÿ†˜ Need Help?** [**Open our contact form**](https://tally.so/r/BzdKgA) to request a new scraper, propose a custom data project, or report an issue. *** > **โš ๏ธ Disclaimer:** this Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Urban Dictionary, LLC. All trademarks mentioned are the property of their respective owners. Only publicly available crowd-sourced data is collected. # Actor input Schema ## `maxItems` (type: `integer`): Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000 ## `mode` (type: `string`): How to collect definitions. ## `terms` (type: `array`): Slang words or phrases to look up. Only used when mode is 'Define'. Each term may return multiple competing definitions ranked by community votes. ## `definitionsPerTerm` (type: `integer`): Maximum competing definitions to keep for each looked-up term. Default 1 returns only the top-voted definition. ## `minThumbsUp` (type: `integer`): Drop any definition with fewer upvotes than this threshold. Set to 0 to keep every result. ## Actor input object example ```json { "maxItems": 10, "mode": "define", "terms": [ "yeet", "cap", "fire", "slay", "vibes" ], "definitionsPerTerm": 1 } ``` # Actor output Schema ## `overview` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "maxItems": 10, "mode": "define", "terms": [ "yeet", "cap", "fire", "slay", "vibes" ], "definitionsPerTerm": 1, "minThumbsUp": 0 }; // Run the Actor and wait for it to finish const run = await client.actor("parseforge/urbandictionary-definitions-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "maxItems": 10, "mode": "define", "terms": [ "yeet", "cap", "fire", "slay", "vibes", ], "definitionsPerTerm": 1, "minThumbsUp": 0, } # Run the Actor and wait for it to finish run = client.actor("parseforge/urbandictionary-definitions-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "maxItems": 10, "mode": "define", "terms": [ "yeet", "cap", "fire", "slay", "vibes" ], "definitionsPerTerm": 1, "minThumbsUp": 0 }' | apify call parseforge/urbandictionary-definitions-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=parseforge/urbandictionary-definitions-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Urban Dictionary Definitions Scraper", "description": "Scrape Urban Dictionary slang definitions: word, definition, example, author, thumbs up, thumbs down, date, defid, and permalink. Track new and trending internet slang, memes, and youth vocabulary. Export to JSON, CSV, or Excel for cultural research, NLP datasets, and trend monitoring.", "version": "1.0", "x-build-id": "CDMNucjrJ7wYDd2oa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~urbandictionary-definitions-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-urbandictionary-definitions-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/parseforge~urbandictionary-definitions-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-urbandictionary-definitions-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/parseforge~urbandictionary-definitions-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-urbandictionary-definitions-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" }, "mode": { "title": "Mode", "enum": [ "define", "random", "wordOfTheDay" ], "type": "string", "description": "How to collect definitions." }, "terms": { "title": "Terms", "type": "array", "description": "Slang words or phrases to look up. Only used when mode is 'Define'. Each term may return multiple competing definitions ranked by community votes.", "items": { "type": "string" } }, "definitionsPerTerm": { "title": "Definitions per Term", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum competing definitions to keep for each looked-up term. Default 1 returns only the top-voted definition." }, "minThumbsUp": { "title": "Minimum Upvotes", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Drop any definition with fewer upvotes than this threshold. Set to 0 to keep every result." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```