PUBLIC API / V1 / READ ONLY

Public data API

Sites, stats, published detection reports, and the latest detection verdict. Read-only, no API key, 60-second cache, CORS open.

Base URL   https://agentapiai.com
Auth       none
Cache      public, max-age=60
Version    X-API-Version: 1.0
OpenAPI    /v1/openapi.json

Endpoints

GET /v1/sites — limit (max 200), offset, grade, q, sort.
GET /v1/sites/{slug} — one public site record.
GET /v1/stats — site count, samples, grade buckets, dataset version.
GET /v1/reports — published detection reports only.
GET /v1/detect/latest?host= — latest published verdict for a host; 404 when none.

Example

curl -sS 'https://agentapiai.com/v1/sites?grade=a&limit=5'
curl -sS 'https://agentapiai.com/v1/stats'

List responses include meta.datasetVersion and meta.generatedAt. Cite the dataset version when you quote a number. A missing detection report is not a pass.

What it does not contain

No API keys, full probe URLs, user identities, or payment data.
No write endpoints: no orders, top-ups, config changes, or deletion.
No paid placement or ranking changes.

Chinese page: 公开 API. CLI source lives in cli/; the GitHub Action lives in action/.