canonical: https://jentic.com/apis/fungenerators.com/fungenerators-random-facts # Fungenerators Facts API The Facts API serves random facts, on-this-day events, birth and death anniversaries, number-based trivia, and keyword search across a curated facts corpus. Twelve endpoints cover random retrieval, search, category listing, fact-of-the-day, on-this-day events, and direct CRUD-like operations on individual facts. The API powers daily content widgets, classroom activities, social media filler, voice assistant briefings, and chatbot small talk. Responses are short JSON payloads that drop into UIs and agent tool outputs without further shaping. ## For AI agents Retrieve random facts, fact-of-the-day, on-this-day events, number trivia, and search the facts corpus by keyword. ## Scope Does not verify factual accuracy in real time, fetch news, or generate quiz questions - use for retrieving curated random facts and on-this-day content only. ## Capabilities - Retrieve a random fact for general-purpose content surfaces - Get a daily fact-of-the-day from a chosen category - Look up on-this-day events, births, and deaths for a given date - Generate a fact about a specific number for math and trivia widgets - Search the facts corpus by keyword for topical content - List all supported fact categories for selection menus ## Use cases ### Daily Content Widgets and Newsletters Editorial teams use the Facts API to power 'fact of the day' widgets, daily newsletter intros, and homepage banners. The fact-of-the-day endpoint delivers a category-relevant item per day, while the on-this-day endpoints add anniversary content automatically. Integration is a small set of cached calls per category. Example prompt: Each morning call GET `/fact/fod` for category=history and GET `/fact/onthisday/event` for today's date, then publish both items in the newsletter. ### Classroom and Educational Apps Teachers and edtech apps use the Facts API for warmup activities, daily trivia, and prompt material. The category list and search endpoints let learners drill into specific topics, and number trivia adds context to maths lessons. The corpus is curated, so output is suitable for school-age audiences when categories are scoped. Example prompt: For a maths warmup, call GET `/fact/numbers` with number=12 and present the returned fact to the class. ### Voice Assistant and Chatbot Small Talk Voice assistants and chatbots use the random fact and search endpoints to fill conversational gaps with relevant trivia. The bot can answer 'tell me a fun fact about space' by calling the search endpoint with the keyword and reading the result back, or fall back to a random fact when the user's intent is open-ended. Example prompt: When the user says 'tell me something interesting about space', call GET `/fact/search` with q=space and read the first result aloud. ### AI Agent Daily Briefing Tool Wire the Facts API into Jentic so any agent can produce a quick on-this-day briefing or a topical fact on demand. Through Jentic the agent searches by intent, the bearer token stays vaulted, and the agent receives structured fact JSON it can summarise in a chat reply or push to a daily digest channel. Example prompt: Use Jentic to search 'get on this day events for today', load GET `/fact/onthisday/event`, and execute it with month and day for the current date. ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/fact/random` | Retrieve a random fact | | GET | `/fact/fod` | Get the fact of the day | | GET | `/fact/onthisday/event` | Get historical events for a date | | GET | `/fact/onthisday/born` | Get notable births on a date | | GET | `/fact/onthisday/died` | Get notable deaths on a date | | GET | `/fact/numbers` | Get trivia about a specific number | | GET | `/fact/search` | Search facts by keyword | | GET | `/fact/categories` | List fact categories | ## Key resources - **Random Fact** — Get a random fact - **Fact of the Day** — Daily fact in a chosen category - **On This Day** — Events, births, and deaths for a date - **Number Facts** — Trivia about a specific number - **Search** — Keyword search across the facts corpus - **Categories** — List of supported fact categories ## Why Jentic - **Setup:** Wiring the Fungenerators Facts API by hand means passing your API key as a bearer token in the Authorization header on api.fungenerators.com and mapping the random, daily-fact, on-this-date, numbers, and search routes yourself. Through Jentic you install once, import the Facts API from the API Directory, store the token once, and your agent calls it. - **Permission scoping:** The Facts API is read-only and takes its input in query parameters rather than a resource path, so you limit the agent to the operations it needs, such as fetching a random fact, on-this-date events, or a keyword search. You choose which operations it may call, and nothing outside that set runs. - **Credential handling:** Your Fungenerators token is stored once, encrypted, by your own Jentic One instance and injected into the Authorization header at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'get on this day events for today' or 'search facts by keyword', and Jentic returns the matching GET `/fact/onthisday/event` or GET `/fact/search` operation with its parameter schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **Trivia API** — Same vendor; question-answer trivia format instead of standalone facts - **Random Riddles API** — Same vendor; pairs riddles with facts for daily content rotation - **Name Generation API** — Same vendor; combines themed names with facts for richer content surfaces ## FAQ ### What authentication does the Facts API use? It uses HTTP bearer token authentication. Through Jentic the bearer token is stored encrypted and attached at request time, so the agent never sees the raw secret. ### Can I get on-this-day events with the Facts API? Yes. Call GET `/fact/onthisday/event` with month and day parameters for events, GET `/fact/onthisday/born` for births, and GET `/fact/onthisday/died` for deaths. ### What are the rate limits for the Facts API? The OpenAPI spec does not declare explicit rate limits. Fungenerators applies plan-based quotas listed on its subscription page at fungenerators.com, so consult your plan for the per-minute and per-day caps. ### How do I retrieve a daily fact through Jentic? Search 'get the fact of the day' via the Jentic SDK or MCP server, load GET `/fact/fod`, and execute it with the desired category. Install with pip install jentic and authenticate using your ak_* key. ### Can I search the facts corpus by keyword? Yes. Call GET `/fact/search` with the q query parameter set to your keyword. The endpoint returns matching facts as a JSON array. ### Does the API include fact categories I can browse? Yes. Call GET `/fact/categories` to list every supported category, then pass the chosen category into endpoints like GET `/fact/fod` or GET `/fact/random` where supported. ### Can I limit what my agent is allowed to do with the Facts API? Yes. The Facts API is read-only and takes its input through query parameters, so on your self-hosted Jentic One instance you set the rules that decide which operations the agent may call, such as GET `/fact/random`, GET `/fact/onthisday/event`, GET `/fact/numbers`, or GET `/fact/search.` You choose the exact set it can reach, and any operation outside that set does not run. Your Fungenerators token stays under your control and is attached only to the calls you permit.