Public Developer Portal

API Documentation

Integrate universal daily knowledge into your applications. Our REST API is free, fast, and requires no registration.

API Endpoints

GET /api/{category}

Fetch today's item for a specific category.

https://otd.lol/api/facts

GET /api/{category}/all

Get the entire localized archive of a category.

https://otd.lol/api/phobias/all

Response Schema

Field	Type	Description
`category`	string	The category key (e.g., "facts")
`day`	number	Day of the year (1-366)
`item`	object	The OTD item payload
`item.id`	number	Unique item identifier
`item.text`	string	The primary content text
`item.name`	string	(Phobias only) The name of the phobia

JSON Preview

{
  "category": "facts",
  "day": 100,
  "item": {
    "id": 123,
    "text": "The Eiffel Tower can be 15 cm taller during the summer.",
    "category": "Science"
  }
}

Status Codes

200

Request successful.

400

Bad Request

Invalid parameters provided.

404

Not Found

Category does not exist.

500

Server Error

Internal OTD.LOL error.