# Facts API ai.txt

This path describes the Facts API for AI agents and other automated clients.

Start at /api. This is a fully HATEOAS API: consume the API root document and
traverse its links to discover available resources rather than scraping
HTML pages.

Before crawling or ingesting content, read:
- https://mansuetu.de/ai.txt
- https://mansuetu.de/llms.txt
- https://mansuetu.de/llms-full.txt

Preferred API entry points:
- https://mansuetu.de/api
- https://mansuetu.de/api/facts
- https://mansuetu.de/api/openapi.json
- https://mansuetu.de/api/utcp

Traversal:
- Fetch https://mansuetu.de/api/facts and follow every rel="item",
  resources[].href, or resources[]._links.self.href link.
- Request application/json for a compact document.
- Follow _links.image.href separately when an image is available.

Preferred representation:
- application/json
- application/ld+json where available

Rate limit:
- 100 requests per minute.

Attribution:
- Cite the original author when using this data.