Developer API

Scan public sites from your own tools.

Siteline's free public API returns the same complete scan envelope as the web UI: an evidence-based view of public machine usability, agent accessibility, and operational handoff paths. 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

Positioning boundary

Siteline is an observability and interoperability instrument for public machine-mediated interaction. It is not AI SEO, GEO scoring, chatbot optimization, prompt engineering, LLM manipulation, or a guarantee that agents can complete authenticated workflows.

Detection-only semantic signals

Scan results can report assistant guides, ontology files, relationship maps, and HTML machine-resource discovery links under informational.semanticResources. These signals are informational only and do not affect score or grade caps.

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