# AI Insight Public API

This site is content-first; only minimal read-only endpoints are exposed.
All endpoints return JSON unless noted.

## Discoverable endpoints

- `GET /api/version` — build introspection (name, version, runtime)
- `GET /api/health` — liveness probe (status, uptime_seconds)
- `GET /api/health/db` — DB readiness probe (db: up/down, latency_ms; 503 on failure)
- `GET /api/ping` — ultra-low-latency text/plain "pong" (LB-friendly)
- `GET /api/sitemap.json` — machine-readable site index
- `GET /api/feeds.json` — RSS / Atom / JSON Feed URLs
- `GET /api/openapi.json` — OpenAPI 3.1 spec for the public endpoints above
- `GET /api/release.json` — recent release notes (most recent 5, version + title + date)
- `GET /api/well-known.json` — index of /.well-known/* + root discovery files (security.txt, change-password, robots.txt, humans.txt, llms.txt, sitemap.xml)
- `GET /api/contributors.json` — parsed humans.txt: founder + AI Agent Hall of Fame as JSON
- `GET /api/network.json` — related sister sites in the vansin ecosystem (paperscope.ai, intern-aip.art, vansin.me)
- `GET /api/whoami.json` — request echo: IP / UA / preferred language / Save-Data / Sec-Fetch-* (debug helper)

## Feeds (root paths)

- `GET /rss.xml` — RSS 2.0
- `GET /atom.xml` — Atom 1.0
- `GET /feed.json` — JSON Feed v1.1
- `GET /sitemap.xml` — XML sitemap

## Discovery files

- `GET /robots.txt` — search engine + AI bot rules
- `GET /humans.txt` — credits + AI agent Hall of Fame
- `GET /llms.txt` — LLM-friendly content discovery
- `GET /.well-known/security.txt` — RFC 9116 vulnerability disclosure
- `GET /.well-known/change-password` — W3C password-change discovery (302 → /dashboard)

## Authenticated v1 API

A REST API v1 exists at `/api/v1/*` but requires an API key.
Free-tier keys (1k/day) available after sign-in at /dashboard/api-keys.

## License

Content: CC BY-SA 4.0 (see /llms.txt).
Code: not open-source. Embedding or republishing summaries with link-back is permitted.

## Contact

- Email: smartflowaiteam@gmail.com
- Security: /.well-known/security.txt
- GitHub: https://github.com/vansin