Install Jentic One Beta

Connect the Facts API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Facts API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Ffungenerators.com%2Ffungenerators-random-facts" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Ffungenerators.com%2Ffungenerators-random-facts" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Facts API.

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

GET STARTED

Start building with Facts API

Explore with Jentic One

View OpenAPI Document

Use Cases

Patterns agents use Facts API for, with concrete tasks.

★ 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.

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.

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.

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.

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

12 endpoints — 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.

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

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

Why Jentic?

What agents get from Jentic-routed access to this vendor.

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 isolation

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.

Intent-based discovery

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.

FAQs

Specific to using Facts API through Jentic.

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.

Fungenerators Facts API

Name: Facts API
Brand: Facts API
Availability: InStock

Browse all Fungenerators APIs

Official vendor OpenAPI document · agent-readyData EnrichmentData Transformationbearer12 EndpointsREST

For Agents

Retrieve random facts, fact-of-the-day, on-this-day events, number trivia, and search the facts corpus by keyword.

Use for: Retrieve a random fact for the homepage banner, Get the fact of the day in the science category, Find historical events that happened on June 10, Look up who was born on this day

Not supported: 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.

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.

Jentic One on Github View OpenAPI Document