Custom Connector
Numbers API Connector
Global
The Numbers API Connector provides access to trivia, mathematical facts, historical events, and interesting data about numbers, dates, and years via the official Numbers API. It lets users fetch fun or educational facts for a specific number or at random — ideal for educational platforms, entertainment apps, and fact-based widgets.
Overview
Integration Overview
The Numbers API Connector exposes the following endpoints:
- Get trivia fact. Retrieve a trivia fact about a number.
- Get math fact. Retrieve a mathematical fact about a number.
- Get date fact. Retrieve a historical fact about a date.
- Get year fact. Retrieve a fact about a year.
- Get random fact. Retrieve a random fact (trivia, math, date, or year).
Documentation
Detailed Integration Documentation
Get Trivia Fact
| Operation ID | getNumberTrivia |
|---|---|
| Endpoint | /{number}/trivia |
| Parameters | number (path, integer | string) – any integer, or “random” for a random trivia fact. json (query, boolean) – return JSON instead of plain text. |
| Purpose | Returns a trivia fact about the given number. |
| Output | Text or JSON with the trivia fact. |
| Workflow example | Show a “fun fact of the day” about a user’s favorite number. |
Get Math Fact
| Operation ID | getNumberMathFact |
|---|---|
| Endpoint | /{number}/math |
| Parameters | number (path, integer | string) – any integer, or “random”. json (query, boolean). |
| Purpose | Retrieves a mathematical fact about the number. |
| Output | Text or JSON with the fact. |
| Workflow example | Enrich math learning platforms with number facts. |
Get Date Fact
| Operation ID | getDateFact |
|---|---|
| Endpoint | /{month}/{day}/date |
| Parameters | month (path, integer) – 1–12. day (path, integer) – 1–31. json (query, boolean). |
| Purpose | Returns a historical event or fact related to the date. |
| Output | Text or JSON with the fact. |
| Workflow example | Daily history features (“On this day in history”). |
Get Year Fact
| Operation ID | getYearFact |
|---|---|
| Endpoint | /{year}/year |
| Parameters | year (path, integer | “random”). json (query, boolean). |
| Purpose | Provides a fact related to the specified year. |
| Output | Text or JSON with the fact. |
| Workflow example | Display context in historical timelines or learning apps. |
Get Random Fact
| Operation ID | getRandomFact |
|---|---|
| Endpoint | /random |
| Parameters | type (query, string) – restrict type of fact: trivia, math, date, or year. json (query, boolean). |
| Purpose | Returns a random fact, optionally restricted by type. |
| Output | Text or JSON with the fact. |
| Workflow example | Generate a “random fact” widget. |
Example Workflow: Daily Fun Facts Widget
| User opens app | Call /random/trivia?json to fetch a fun random trivia fact. |
|---|---|
| User enters birthdate | Call /{month}/{day}/date?json. |
| User explores math | Call /{number}/math?json. |
| App suggests history | Call /{year}/year?json. |
Support
For technical support, contact custom-connectors-support@isolutions.sa.