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.
- 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.
- 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.
- Clone the repo:
git clone https://github.com/your-username/chuck-norris-actor.git
- Setup Environment:
python -m venv myenv
.\myenv\Scripts\Activate.ps1
pip install -r requirements.txt
- Configure Input:
Edit
storage/key_value_stores/default/INPUT.jsonto change joke limits or categories. - Run with Apify CLI:
apify run
| 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. |