Urban Dictionary API Actor

An Apify Actor for retrieving slang definitions, meanings, and cultural expressions from Urban Dictionary. Perfect for content creators, researchers, and developers needing access to contemporary language data.

🚀 Features

• Bulk Definition Extraction: Retrieve multiple terms simultaneously for efficient data collection.
• Advanced Filtering: Filter results based on vote scores and popularity metrics to get high-quality definitions.
• Real-Time Data Retrieval: Access up-to-date slang definitions with customizable search parameters.
• Structured Output: Consistent JSON schema for easy integration with external applications.
• Apify Integration: Seamlessly run on the Apify platform with dataset storage and export options.

📥 Input

Configure the actor with the following parameters:

Field	Type	Description	Default
term	string	Single word or phrase to search for definitions	-
terms	string	Multiple terms separated by commas (e.g., yeet, sus, on fleek)	-
limit	integer	Maximum number of definitions per term	10
min_upvotes	integer	Minimum upvotes required for a definition	0
min_downvotes	integer	Minimum downvotes required for a definition	0

Input Examples

Single Term Search:

{
  "term": "yeet",
  "limit": 5
}

Bulk Extraction:

{
  "terms": "yeet, sus, on fleek",
  "min_upvotes": 50
}

Filtered Search:

{
  "term": "lol",
  "min_upvotes": 100,
  "limit": 20
}

📤 Output

The actor outputs structured data to an Apify dataset. Each item includes:

Field	Type	Description
word	string	The searched term
definition	string	The definition text
example	string	Usage example
author	string	Contributor name
date	string	Date of submission
upvotes	integer	Number of upvotes
downvotes	integer	Number of downvotes
additional	object	Raw additional data

Sample Output Item

{
  "word": "yeet",
  "definition": "A word one may scream while propelling an object through the air at alarming speeds.",
  "example": "YEET! Mei screamed, hurling the football at her catcaller's head.",
  "author": "carryingthebanner",
  "date": "October 23, 2017",
  "upvotes": 1234,
  "downvotes": 56,
  "additional": {
    // Additional metadata
  }
}

🛠️ Usage

On Apify Platform

1. Create a New Task: Go to Apify Console and create a new task for this actor.
2. Configure Input: Use the input schema to set your search parameters.
3. Run the Actor: Execute the task and monitor progress.
4. Download Results: Export the dataset in JSON, CSV, or XML format.

Local Development

For local testing:

1. Clone the repository.
2. Prepare your input JSON file (e.g., INPUT.json).
3. Run the actor using Apify CLI.

⚙️ Configuration

Environment Variables

• API_BASE: Override the default data source URL (optional, for advanced users).

Best Practices

• Rate Limiting: For high-volume requests, consider using Apify Proxy to avoid potential rate limits.
• Filtering: Use min_upvotes to ensure quality definitions.
• Bulk Processing: For large term lists, monitor memory usage.

📊 Use Cases

• Content Creation: Stay updated with trending slang for social media.
• Research: Analyze contemporary language evolution.
• Chatbots: Enhance NLP models with modern vocabulary.
• Marketing: Understand youth culture and communication trends.
• Education: Teach modern linguistics and slang.

📋 Notes

• Results are filtered client-side based on input criteria.
• The actor accesses a remote dictionary source; ensure stable internet connection.
• For large datasets, consider pagination or splitting into multiple runs.
• Data accuracy depends on the source; definitions may vary over time.

🤝 Contributing

Found an issue or have a suggestion? Open an issue on the Apify platform or contact support.

---

This actor provides access to Urban Dictionary data for research and entertainment purposes. Always respect content guidelines and usage policies.