Developer API

Scan public sites from your own tools.

Siteline's free public API returns the same complete scan envelope as the web UI. It is low-rate and unauthenticated by design; paid API keys, retained results, batch scans, and usage dashboards remain future platform work.

OpenAPI YAML OpenAPI JSON Limits

First request

curl "https://siteline.to/api/scan?url=example.com"

The response includes `grade`, `score`, pillar scores, findings, evidence, provenance, and a `resultId` when the scan is stored.

Optional site-type hint

curl "https://siteline.to/api/scan?url=example.com&siteType=docs"

Hints are stored as hints, not score authority. The scanner still requires evidence before applying profile-specific rubric behavior.

Result lookup

curl "https://siteline.to/api/result?id=example-com-20260428"

Stored public results are retained for the free permalink window. Account-owned history and diffs are reserved for paid Monitoring.

Badges and share images

https://siteline.to/badge/example-com-20260428.svg
https://siteline.to/badge/example-com-20260428-horizontal.svg
https://siteline.to/badge/example-com-20260428-dark.svg

Badge endpoints are intended for basic public embedding. Branded agency badges remain a paid White-Label capability.

Machine-readable discovery

Hosted API status

Free API discovery and low-rate scanning are live. API keys, higher quotas, usage tracking, batch jobs, and webhooks are not self-serve yet.

Ask about API volume