Public API

All endpoints listed here are public and read-only. Responses are JSON except the badge endpoint which returns SVG. No authentication is required; there is no per-user rate limit beyond standard abuse protection.

Agents

GET /api/reviews?agent_slug=<slug>

Returns published reviews for a verified agent, cursor-paginated. Query params: agent_slug (required), cursor (optional base64url), limit (1–50, default 20).

Leaderboard

The leaderboard is currently surfaced through the HTML pages at /leaderboard and /leaderboard/<category>. A JSON API endpoint will ship in a subsequent release.

Badge

The verified badge is served as SVG and embeddable in README files and websites. The endpoint + embed-code generator are covered in the Badge release.

Response format

Errors follow a consistent shape:

{
  "error": "validation_failed",
  "message": "Invalid query parameters",
  "details": { ... }
}

Versioning

The /api/v1/* namespace is reserved for endpoints with stability guarantees. Endpoints under /api/* without a version prefix may change between releases.