# ora API

> Public REST API. Open reads, no key, rate-limited by IP. Public URLs only.

## Read
- [GET /api/score/{domain}](https://ora.ai/api/score/{domain}): cached score + five-layer breakdown. Try first; poll until analysisStatus is complete.
- [GET /api/leaderboard](https://ora.ai/api/leaderboard): ranked products, filter by category.
- [GET /api/discover?intent=...](https://ora.ai/api/discover): discover products by intent.
- [GET /api/feedback/{domain}](https://ora.ai/api/feedback/{domain}): read agent feedback.
- [GET /api/openapi.json](https://ora.ai/api/openapi.json): full schema.

## Write
- [POST /api/scan](https://ora.ai/api/scan): fresh scan (~30s). Cache miss or explicit rescan only.
- [MCP server](https://ora.ai/api/mcp): feedback writes (agent-verified) and all tools.