The Deep Page Audit API from santosautomation-com — 3 operation(s) for deep page audit.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/santosautomation-com:santosautomation-com-deep-page-audit-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Santos Website Intelligence Deep Page Audit API
version: 2.18.0
description: 'AI Website Intelligence for determining whether public websites can be discovered, understood, trusted, and used by agents. Twelve paid capabilities use USDC on Base mainnet (eip155:8453) via x402 v2 with no account or traditional API key. QUICK INTELLIGENCE (GET /api/audit, $0.015, synchronous): lightweight single-page fetch-and-parse audit. AGENT READINESS (GET /api/agent-readiness, $0.075, synchronous): bounded passive discovery and applicability-aware assessment of agent-facing interfaces. DEEP WEBSITE INTELLIGENCE (POST /v1/audits, $0.225, asynchronous): real Chromium via Playwright, Lighthouse, rendered axe-core, browser evidence, screenshots, and passive security checks. The other eight paid capabilities — SAFE FETCH (GET /v1/fetch, $0.002), CONTENT EXTRACTION (POST /v1/extract, $0.005), FEED PARSER (GET /v1/feed, $0.003), LINK MAP (GET /v1/links, $0.003), SUMMARIZER (POST /v1/summarize, $0.033), SCREENSHOT & PDF RENDER (GET /v1/screenshot, $0.01), STRUCTURED EXTRACTION (POST /v1/extract/structured, $0.08), and BATCH QUICK INTELLIGENCE (POST /api/audit/batch, $0.50 flat for up to 50 URLs) — are documented per-path below. Quick and Agent Readiness payments settle only on a successful response; Deep payment purchases a bounded compute reservation and settles when the job is accepted.'
contact:
name: Santos Automation
email: info@santosautomation.com
url: https://www.santosautomation.com
servers:
- url: https://api.santosautomation.com
tags:
- name: Deep Page Audit
paths:
/v1/audits/{job_id}:
get:
operationId: getDeepAuditStatus
security: []
tags:
- Deep Page Audit
summary: Job status (requires access token)
parameters:
- name: job_id
in: path
required: true
schema:
type: string
- name: token
in: query
required: false
schema:
type: string
description: 'Job access token (alternative to Authorization: Bearer).'
responses:
'200':
description: Job state.
content:
application/json:
schema:
type: object
properties:
job_id:
type: string
description: Unguessable job id (aud_...).
status:
type: string
enum:
- queued
- running
- aggregating
- completed
- failed
- expired
- cancelled
stage:
type:
- string
- 'null'
progress:
type: integer
minimum: 0
maximum: 100
access_token:
type: string
description: Returned ONCE at creation; required (Bearer or ?token=) for every status/report/events/cancel call. Job ids alone are never authorization.
status_url:
type: string
format: uri
report_url:
type: string
format: uri
events_url:
type: string
format: uri
artifacts_url:
type: string
format: uri
payment_contract:
type: string
error_code:
type: string
error_message:
type: string
'401':
description: Missing/invalid access token.
content:
application/json:
schema:
type: object
required:
- error
properties:
error:
type: string
description: Human-readable explanation.
code:
type: string
description: Stable machine-readable error code.
enum:
- INVALID_URL
- UNSUPPORTED_SCHEME
- PRIVATE_ADDRESS_BLOCKED
- RATE_LIMITED
- FREE_TIER_RETIRED
- AUDIT_TIMEOUT
- TARGET_UNREACHABLE
- AUDIT_FAILED
- INVALID_EXTRACTION_SCHEMA
- STRUCTURED_OUTPUT_INVALID
'404':
description: Unknown job.
content:
application/json:
schema:
type: object
required:
- error
properties:
error:
type: string
description: Human-readable explanation.
code:
type: string
description: Stable machine-readable error code.
enum:
- INVALID_URL
- UNSUPPORTED_SCHEME
- PRIVATE_ADDRESS_BLOCKED
- RATE_LIMITED
- FREE_TIER_RETIRED
- AUDIT_TIMEOUT
- TARGET_UNREACHABLE
- AUDIT_FAILED
- INVALID_EXTRACTION_SCHEMA
- STRUCTURED_OUTPUT_INVALID
/v1/audits/{job_id}/report:
get:
operationId: getDeepAuditReport
security: []
tags:
- Deep Page Audit
summary: Completed report (versioned JSON, requires access token)
description: 'schema_version 3.0.0. Sections: target, engines (Chromium/Lighthouse/axe versions), module_status, deterministic scores + scoring_method, lab metrics (labeled laboratory data), network metrics, normalized findings (stable id, engine, category, severity, confidence, status, evidence, standards, recommendation), optional ai_summary (model-generated narrative, clearly labeled), artifacts with short-lived signed download URLs, and explicit limitations.'
parameters:
- name: job_id
in: path
required: true
schema:
type: string
- name: token
in: query
required: false
schema:
type: string
responses:
'200':
description: The report.
content:
application/json:
schema:
type: object
properties:
schema_version:
type: string
const: 3.0.0
scores:
type: object
website_intelligence_score:
type:
- integer
- 'null'
website_intelligence:
$ref: '#/components/schemas/WebsiteIntelligence'
agent_readiness:
$ref: '#/components/schemas/AgentReadinessResult'
findings:
type: array
items:
type: object
'401':
description: Missing/invalid access token.
content:
application/json:
schema:
type: object
required:
- error
properties:
error:
type: string
description: Human-readable explanation.
code:
type: string
description: Stable machine-readable error code.
enum:
- INVALID_URL
- UNSUPPORTED_SCHEME
- PRIVATE_ADDRESS_BLOCKED
- RATE_LIMITED
- FREE_TIER_RETIRED
- AUDIT_TIMEOUT
- TARGET_UNREACHABLE
- AUDIT_FAILED
- INVALID_EXTRACTION_SCHEMA
- STRUCTURED_OUTPUT_INVALID
'404':
description: Unknown job or expired report.
content:
application/json:
schema:
type: object
required:
- error
properties:
error:
type: string
description: Human-readable explanation.
code:
type: string
description: Stable machine-readable error code.
enum:
- INVALID_URL
- UNSUPPORTED_SCHEME
- PRIVATE_ADDRESS_BLOCKED
- RATE_LIMITED
- FREE_TIER_RETIRED
- AUDIT_TIMEOUT
- TARGET_UNREACHABLE
- AUDIT_FAILED
- INVALID_EXTRACTION_SCHEMA
- STRUCTURED_OUTPUT_INVALID
'409':
description: Job not completed yet (code REPORT_NOT_READY, includes status/stage/progress).
content:
application/json:
schema:
type: object
required:
- error
properties:
error:
type: string
description: Human-readable explanation.
code:
type: string
description: Stable machine-readable error code.
enum:
- INVALID_URL
- UNSUPPORTED_SCHEME
- PRIVATE_ADDRESS_BLOCKED
- RATE_LIMITED
- FREE_TIER_RETIRED
- AUDIT_TIMEOUT
- TARGET_UNREACHABLE
- AUDIT_FAILED
- INVALID_EXTRACTION_SCHEMA
- STRUCTURED_OUTPUT_INVALID
/v1/audits/{job_id}/cancel:
post:
operationId: cancelDeepAudit
security: []
tags:
- Deep Page Audit
summary: Cancel a queued job (requires access token)
description: Only queued jobs can be cancelled; running/terminal jobs return 409 NOT_CANCELLABLE. The compute reservation is spent either way.
parameters:
- name: job_id
in: path
required: true
schema:
type: string
responses:
'200':
description: Cancelled.
'401':
description: Missing/invalid access token.
'409':
description: Not cancellable.
components:
schemas:
AgentReadinessResult:
$schema: https://json-schema.org/draft/2020-12/schema
$id: https://api.santosautomation.com/schemas/agent-readiness-result-1.0.0.json
title: AgentReadinessResult
type: object
required:
- schema_version
- target
- profile
- readiness_level
- score
- grade
- confidence
- tested_coverage_percent
- applicability
- subscores
- interfaces
- findings
- recommended_actions
- limitations
properties:
schema_version:
type: string
const: 1.0.0
website_intelligence_score:
type:
- integer
- 'null'
minimum: 0
maximum: 100
website_intelligence:
type: object
description: Additive AI Website Intelligence presentation with four dimensions, coverage, confidence, and prioritized fixes.
properties:
schema_version:
type: string
const: 1.0.0
score:
type:
- integer
- 'null'
minimum: 0
maximum: 100
dimensions:
type: object
properties:
discoverable:
type:
- integer
- 'null'
minimum: 0
maximum: 100
understandable:
type:
- integer
- 'null'
minimum: 0
maximum: 100
callable:
type:
- integer
- 'null'
minimum: 0
maximum: 100
trustworthy:
type:
- integer
- 'null'
minimum: 0
maximum: 100
target:
type: object
required:
- requested_url
- canonical_origin
- final_url
properties:
requested_url:
type: string
canonical_origin:
type: string
format: uri
final_url:
type: string
format: uri
additionalProperties: false
profile:
type: string
enum:
- general_website
- documentation_site
- api_provider
- mcp_provider
- agent_commerce_provider
readiness_level:
type: object
required:
- level
- name
properties:
level:
type: integer
minimum: 0
maximum: 4
name:
type: string
additionalProperties: false
score:
type: integer
minimum: 0
maximum: 100
grade:
type: string
enum:
- A
- B
- C
- D
- F
confidence:
type: number
minimum: 0
maximum: 1
tested_coverage_percent:
type: integer
minimum: 0
maximum: 100
applicability:
type: object
additionalProperties:
type: string
enum:
- tested
- not_applicable
- unknown
subscores:
type: object
additionalProperties:
type: integer
minimum: 0
maximum: 100
interfaces:
type: object
findings:
type: array
items:
type: object
required:
- id
- category
- severity
- confidence
- status
- title
- recommendation
properties:
id:
type: string
category:
type: string
severity:
type: string
enum:
- info
- low
- moderate
- high
confidence:
type: string
enum:
- low
- medium
- high
status:
type: string
enum:
- pass
- fail
- unknown
- not_applicable
title:
type: string
evidence:
type: object
recommendation:
type: string
recommended_actions:
type: array
items:
type: object
limitations:
type: array
items:
type: string
fetch_budget:
type: object
WebsiteIntelligence:
type: object
description: Additive presentation-layer synthesis. Historical score fields retain their established semantics.
required:
- schema_version
- score
- dimensions
- applicability
- coverage
- scoring_note
properties:
schema_version:
type: string
const: 1.0.0
score:
type:
- integer
- 'null'
minimum: 0
maximum: 100
dimensions:
type: object
required:
- discoverable
- understandable
- callable
- trustworthy
properties:
discoverable:
type:
- integer
- 'null'
minimum: 0
maximum: 100
understandable:
type:
- integer
- 'null'
minimum: 0
maximum: 100
callable:
type:
- integer
- 'null'
minimum: 0
maximum: 100
trustworthy:
type:
- integer
- 'null'
minimum: 0
maximum: 100
applicability:
type: object
properties:
callable:
type: string
enum:
- tested
- not_applicable
- unknown
description: unknown when the Agent Readiness module failed.
incomplete:
type: object
description: Present when a required module failed; score and dimensions are then null rather than computed from partial evidence.
properties:
missing_modules:
type: array
items:
type: string
reason:
type: string
coverage:
type: object
properties:
tests_available:
type: integer
minimum: 0
tests_executed:
type: integer
minimum: 0
tests_not_applicable:
type: integer
minimum: 0
tests_skipped:
type: integer
minimum: 0
tested_percent:
type: integer
minimum: 0
maximum: 100
confidence:
type:
- number
- 'null'
minimum: 0
maximum: 1
priority_fixes:
type: array
items:
type: object
scoring_note:
type: string