Facts API

Name: Facts API API
Brand: Facts API
Availability: InStock

✓ Official Vendor SpecData 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.

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.

Install Jentic One Beta (Self-Hosted)

Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | 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 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

GET STARTED

Start building with Facts API API

Explore with Jentic

View OpenAPI Document

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.

Use Cases

Patterns agents use Facts API 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

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

The Fungenerators bearer token is stored encrypted in the Jentic vault. Agents call any of the twelve fact operations through Jentic and the token is injected at execution, never inside the agent's prompt or logs.

Intent-based discovery

Agents search Jentic with intents like 'get on this day events for today' or 'search facts by keyword' and receive the matching operation along with its parameter schema, ready to execute.

Time to first call

Direct Fungenerators integration: half a day for auth, retries, and shaping responses across twelve endpoints. Through Jentic: under 30 minutes from search to first successful call.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

Trivia API

Same vendor; question-answer trivia format instead of standalone facts

Choose Trivia when the use case needs Q&A pairs for quizzes rather than declarative facts.

Complementary

Random Riddles API

Same vendor; pairs riddles with facts for daily content rotation

Add Riddles when you want a mix of facts and puzzles in the same daily digest.

Complementary

Name Generation API

Same vendor; combines themed names with facts for richer content surfaces

Use Namegen alongside Facts when building character profiles that need both a name and a contextual fact.

FAQs

Specific to using Facts API 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.