Chuck Norris Jokes API Actor

Access a world of humor with the Chuck Norris Jokes API Actor, designed to efficiently gather and deliver Chuck Norris jokes from multiple online sources. This Actor automates the collection, categorization, and distribution of jokes, ensuring a constantly updated database for your applications.

✨ Key Features

• Automated Scraping: Collects jokes from verified sources like api.chucknorris.io.
• Smart Filtering: Deterministic keyword-based categorization (e.g., Tech, Science, Movies) without the overhead of AI.
• Performance Optimized: Built-in rate limiting and a local caching mechanism using Apify's Key-Value Store.
• Developer Friendly: Seamless integration with clean JSON output formatting.

🚀 Benefits

• Cost-Effective: Zero API costs for LLMs—uses native logic and public endpoints.
• Ultra-Fast: Caching ensures that repeat requests are served instantly.
• Reliable: Designed to handle rate limits and API downtimes gracefully.

🛠️ Local Development

1. Clone the repo:

$git clone https://github.com/your-username/chuck-norris-actor.git

2. Setup Environment:

python -m venv myenv
.\myenv\Scripts\Activate.ps1
pip install -r requirements.txt

3. Configure Input: Edit storage/key_value_stores/default/INPUT.json to change joke limits or categories.
4. Run with Apify CLI:

$apify run

📊 Input Configuration

Field	Type	Description
maxJokes	Integer	Total jokes to retrieve (Default: 10).
category	String	Filter by theme (e.g., dev, sport, food).
searchQuery	String	Keyword to search within jokes.
useCache	Boolean	Enable/Disable the internal caching system.