# Useless Facts API
> Random and daily trivia facts via the open Useless Facts API — no key. The random endpoint returns a surprising, mostly-useless fact; the today endpoint returns the fact of the day; and both are available in English or German, each fact carrying its source attribution, source URL and a permalink. Real curated facts, with the daily fact cached for speed — no key. 3 endpoints. Ideal for daily-fact widgets, newsletters, chatbots, loading screens and onboarding delight.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/uselessfacts-api/..."
```

## Pricing
- **Free** (Free) — 7,200 calls/Mo, 2 req/s
- **Basic** ($5/Mo) — 97,500 calls/Mo, 8 req/s
- **Pro** ($21/Mo) — 560,500 calls/Mo, 20 req/s
- **Mega** ($63/Mo) — 2,730,000 calls/Mo, 50 req/s

## Endpoints

### Facts

#### `GET /v1/random` — A random fact

**Parameters:**
- `language` (query, optional, string) — en or de (default en) Example: `en`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/uselessfacts-api/v1/random?language=en"
```

**Response:**
```json
{
    "data": {
        "fact": {
            "id": "9cde3f7c3ce81b6de2dec0ea231b1dbc",
            "text": "A honeybee can fly at fifteen miles per hour.",
            "source": "djtech.net",
            "language": "en",
            "permalink": "https://uselessfacts.jsph.pl/api/v2/facts/9cde3f7c3ce81b6de2dec0ea231b1dbc",
            "source_url": "https://www.djtech.net/humor/shorty_useless_facts.htm"
        }
    },
    "meta": {
        "timestamp": "2026-06-08T09:48:45.648Z",
        "request_id": "db4f9348-f935-4a97-b95d-b3aee03f7dde"
    },
    "status": "ok",
    "message": "Fact retrieved successfully",
    "success": true
}
```

#### `GET /v1/today` — Fact of the day

**Parameters:**
- `language` (query, optional, string) — en or de (default en) Example: `en`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/uselessfacts-api/v1/today?language=en"
```

**Response:**
```json
{
    "data": {
        "fact": {
            "id": "9decf420a079ab676d06a7101f34a9c8",
            "text": "Laredo, Texas is the U.S.'s farthest inland port.",
            "source": "djtech.net",
            "language": "en",
            "permalink": "https://uselessfacts.jsph.pl/api/v2/facts/9decf420a079ab676d06a7101f34a9c8",
            "source_url": "https://www.djtech.net/humor/shorty_useless_facts.htm"
        }
    },
    "meta": {
        "timestamp": "2026-06-08T09:48:45.751Z",
        "request_id": "2775b6d0-27f5-4c85-96ed-2f8d55252194"
    },
    "status": "ok",
    "message": "Fact of the day retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Spec

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/uselessfacts-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "service": "uselessfacts-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/today": "The fact of the day (language=en|de).",
            "GET /v1/random": "A random useless fact (language=en|de)."
        },
        "description": "Random and daily trivia facts via the open Useless Facts API: pull a random fact or the fact of the day, in English or German, each with its source attribution and permalink. Real facts, no key."
    },
    "meta": {
        "timestamp": "2026-06-08T09:48:45.859Z",
        "request_id": "97f41e1d-454e-4c6c-a278-371bb328d647"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/uselessfacts-api
OpenAPI spec: https://www.oanor.com/api/uselessfacts-api/openapi.json