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 only after storage confirms the save. If persistence.stored is false, the findings remain usable, but sharing, badges, and email are unavailable. Retry the scan to save a report. New IDs use domain-slug-v2-identity-hash-YYYYMMDD; existing report links remain valid. It also carries two informational panels that never affect the grade: external.cloudflare (an attributed Cloudflare Agent Readiness protocol baseline) and standards (Graceful Boundaries and GuideCheck conformance checks).

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

The public interface is REST. The CLI and stdio MCP server require access to the private repository; there is no public MCP installation or hosted MCP endpoint.

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