canonical: https://jentic.com/apis/fungenerators.com

# Fun Generators APIs

Fun Generators is a family of small, focused REST APIs from a single vendor that generate and transform lightweight content on demand. The portfolio spans random facts, trivia, riddles, and themed taunts; pirate and Shakespearean name, insult, lorem ipsum, and translation generation; random name generation across many categories; random lottery number draws; UUID generation; and QR Code and barcode image encoding and decoding. Every API returns short JSON payloads that drop straight into a UI or an agent tool output, and all of them share one Fun Generators subscription and one base host at api.fungenerators.com. The APIs suit daily content widgets, quiz and puzzle apps, classroom warmups, chatbot and voice assistant small talk, novelty and marketing campaigns, and back-office labelling and identifier workflows.

## For AI agents

An agent can generate and search short-form content (facts, trivia, riddles, themed names, taunts, pirate and Shakespearean text) and mint utility artefacts (UUIDs, QR Codes, and barcodes) across the Fun Generators portfolio, then decode QR Code and barcode images back to their contents. All of these run against one shared credential, so one integration covers every generator.

## Scope

Use for: Generating and searching short-form novelty and content items (facts, trivia, riddles, themed names, taunts, pirate and Shakespearean text, lottery number sets) and encoding or decoding QR Code, barcode, and UUID utility artefacts, all against one Fun Generators subscription.

Not supported:
- real-time news retrieval
- fact verification
- quiz scoring engine
- content moderation
- audio or speech
- real lottery draws

## APIs

| API | Category | Endpoints | Description |
| --- | --- | --- | --- |
| Facts API | data-enrichment | 12 | Retrieve random facts, fact-of-the-day, on-this-day events, number trivia, and search the facts corpus by keyword. |
| Fun Generators API | media | 9 | Generate QR Code images for text, URLs, phone, SMS, email, Skype, or business cards, and decode QR Code images back to their contents. |
| Random Riddles API | data-enrichment | 6 | Retrieve random riddles, search the riddles catalogue by keyword, and manage individual riddle records. |
| Trivia API | data-enrichment | 6 | Retrieve random trivia, search the trivia catalogue by keyword, list categories, and manage individual trivia records. |
| Shakespeare API | data-enrichment | 5 | Generate Shakespearean names, insults, lorem ipsum, and quotes, and translate English text into Shakespearean style. |
| Barcode API | media | 4 | Encode a value into a barcode image or decode an uploaded barcode image into its numeric value across many industry standard types. |
| Pirates API | data-enrichment | 4 | Generate pirate-themed names, insults, lorem ipsum, and translate English text into pirate lingo. |
| Random Lottery Number generator API | data-enrichment | 3 | Generate random lottery number draws for popular global lottery games and list which countries and games are supported. |
| UUID Generation API | developer-tools | 3 | Generate UUIDs (default and version-specific) via a small REST API for prototypes, scripts, and agent workflows that need hosted unique identifiers. |
| Name Generation API | data-enrichment | 2 | Generate random names from many themed categories such as fantasy characters, brands, screen names, and pet names. |
| Taunt as a service | data-enrichment | 2 | Generate themed random taunts and insults from many categories, with a separate endpoint to list the available categories. |

## Which API to use

| Need | API | Why |
| --- | --- | --- |
| Fill conversational or content gaps with a short random item | random-facts | Returns declarative standalone facts, on-this-day events, and number trivia rather than question-answer pairs. |
| Fill conversational or content gaps with a short random item | trivia | Returns quiz-style items with category metadata drawn from thousands of categories, best when you want a topic selector. |
| Fill conversational or content gaps with a short random item | riddle | Returns wordplay question-answer riddles for interactive puzzle moments rather than factual content. |
| Generate a scannable code image from a value | qrcode | Encodes URLs, text, contacts, and other payloads as QR Code images and decodes them back. |
| Generate a scannable code image from a value | barcode | Encodes numeric values into industry-standard 1D barcodes for labels and asset tags, and decodes barcode images. |
| Produce a themed insult or taunt | taunt | Generates general themed taunts across many categories, the broadest option for roast features. |
| Produce a themed insult or taunt | pirate | Generates pirate-voiced insults alongside pirate names, lorem ipsum, and translation. |
| Produce a themed insult or taunt | shakespeare | Generates Elizabethan-voiced insults alongside Shakespearean names, quotes, and translation. |
| Generate a random identifier or number set | uuid | Produces universally unique identifiers for records, tickets, and tracked links. |
| Generate a random identifier or number set | lottery | Produces bounded lottery-shaped number draws for supported games rather than universal identifiers. |

## Cross-API use cases

### Daily content widget rotation

Rotate a homepage or newsletter widget through a fact, a piece of trivia, and a riddle so the daily content stays varied without maintaining a corpus. Each morning the agent pulls one item from each source and publishes them together, caching for the day to keep quota use low.

Example prompt: Each morning call the random fact, random trivia, and random riddle operations, then publish all three items in the daily widget and cache them for 24 hours.

### Tracked, scannable asset generation

Mint a unique identifier for each asset or ticket and immediately encode it as a scannable image, producing a traceable artefact in two calls. Choose a QR Code for URL and contact payloads or a barcode for numeric label formats.

Example prompt: Call the UUID generate operation for each asset, then pass the identifier into either the QR Code URL operation or the barcode encode operation to produce a scannable image.

### Themed chatbot persona content

Give a chatbot a consistent themed voice by generating a persona name, translating user prompts into that voice, and lobbing a themed taunt on cue. The same pattern works for a pirate persona, a Shakespearean persona, or a general roast bot.

Example prompt: Generate a persona name from the pirate or Shakespeare generator, translate incoming messages with the matching translate operation, and call the taunt generator when the user asks for a roast.

### Quiz app content and feedback

Back a quiz or classroom app with trivia questions and riddles, then reply to wrong answers with a themed taunt so the feedback stays playful and on-brand. One subscription supplies both the questions and the comedic responses.

Example prompt: Fetch a trivia item or riddle to pose the question, then on an incorrect answer call the taunt generator with a matching category and display the taunt.

## Why Jentic

- **Setup:** Wiring the Fun Generators portfolio by hand means mapping the routes for each generator and encoder separately and threading the subscription credential through each one against api.fungenerators.com. With Jentic you install Jentic One once, then find and add any of the Fun Generators APIs from the Jentic directory into your workspace and let your agent call them.
- **Permission scoping:** Most of these APIs take their input in query or body parameters rather than resource paths, and a few (riddle, trivia) expose write operations like create, update, and delete. Your own rules decide which operations across the portfolio the agent may run, so you can allow read and generation operations while leaving the write operations out of the allowed set.
- **Credential handling:** Your single Fun Generators subscription credential is stored encrypted by your own Jentic One instance and injected as the bearer token or the X-Fungenerators-API-Secret header at execution time, depending on the API. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search the Jentic directory by intent such as 'get a random fact', 'generate a qr code for a url', or 'generate a random lottery draw', and Jentic returns the matching Fun Generators operation with its parameter schema so the agent calls the right endpoint without browsing the reference docs.

## Related vendors

- **API Ninjas** — Offers a broad family of small single-purpose content and utility APIs (facts, trivia, riddles, quotes, generators) under one key, closely paralleling the Fun Generators portfolio.
- **GoQR** — Focused QR Code generation and decoding service, an alternative to the Fun Generators QR Code API for image-only workflows.
- **Numbers API** — Provides number and date trivia, overlapping the number-facts and on-this-day capabilities of the Fun Generators Facts API.
- **Open Trivia Database** — Free trivia question bank with categories, an alternative content source to the Fun Generators Trivia and riddle APIs.

## FAQ

### Does one credential work across all the Fun Generators APIs?

Yes. Every API in the portfolio runs against the same api.fungenerators.com host under one Fun Generators subscription. Some APIs accept the credential as a bearer token in the Authorization header and others as an API key in the X-Fungenerators-API-Secret header, but it is the same underlying subscription key.

### Which Fun Generators APIs generate images rather than text?

The QR Code API and the Barcode API return image output and can also decode uploaded images back into their contents. Every other API in the portfolio returns short text or JSON only, so for a spoken or styled result you would pair the output with a separate provider.

### When should I pick facts, trivia, or riddles for content?

Use the Facts API for declarative standalone facts and on-this-day content, the Trivia API for category-tagged quiz-style items with a topic selector, and the Random Riddles API for wordplay question-answer puzzles. Many content widgets rotate through all three for variety.

### What are the rate limits across the portfolio?

The OpenAPI specs do not declare explicit rate limits. Fun Generators applies plan-based quotas published on its subscription page, so the caps depend on the tier you signed up for. Caching one-shot lookups such as category and supported-game lists keeps runtime calls focused on generation.

### Are these APIs suitable for production or only for novelty use?

It depends on the API. The QR Code, Barcode, and UUID APIs support production labelling, identifier, and tracking workflows, while the fact, trivia, riddle, name, taunt, pirate, Shakespeare, and lottery generators are best treated as content and novelty sources rather than authoritative data.

### Can these APIs verify facts or run a real lottery?

No. The Facts and Trivia APIs return curated content and do not verify accuracy in real time or fetch news, and the Lottery API only generates random lottery-shaped number sets. None of the APIs run real draws, sell tickets, or pay out winnings.