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: json { "term": "yeet", "limit": 5 } Bulk Extraction: json { "terms": "yeet, sus, on fleek", "min_upvotes": 50 } Filtered Search: json { "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 json { "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.