Skip to content
Developer API

API Access

Run audits, read findings and pull evidence-backed scores straight from your own systems — through a versioned REST API. Every value carries its data classification and the artefact version that produced it.

Start & poll audits

Kick off a scan for a project and poll its state until the report is ready.

Read findings & evidence

Pull grouped findings with severity, confidence and the evidence behind each one.

Pull scores & history

Read pillar-weighted scores with their formula version, and compare across scans.

A quick look

Authenticate with a bearer token and call the versioned /api/v1 endpoints.

Start a scan
curl -X POST https://seoartifact.com/api/v1/projects/{project}/scans \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Accept: application/json"
Read findings
curl https://seoartifact.com/api/v1/scans/{scan}/findings \
  -H "Authorization: Bearer <YOUR_API_KEY>"

Every response field carries its data classification (observed, derived, rule-finding, …) and the rule/formula version behind it — so you can reproduce any number on your side.

Ready to build?

API access is free — create an account to generate a key. For higher volume or early access to new endpoints, just reach out.