santosautomation-com Deep Website Intelligence API

The Deep Website Intelligence API from santosautomation-com — 1 operation(s) for deep website intelligence.

Operations 1

POST /v1/audits Create a Deep Website Intelligence job ($0.225 USDC via x402, asynchronous) #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/santosautomation-com:santosautomation-com-deep-website-intelligence-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

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 Specification

santosautomation-com-deep-website-intelligence-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Santos Website Intelligence Deep Website Intelligence 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 Website Intelligence
paths:
  /v1/audits:
    post:
      operationId: createDeepAudit
      tags:
      - Deep Website Intelligence
      summary: Create a Deep Website Intelligence job ($0.225 USDC via x402, asynchronous)
      description: 'Requires x402 v2 payment (base64 PAYMENT-REQUIRED challenge header; retry with PAYMENT-SIGNATURE). The payment purchases one bounded compute reservation — it settles when the job is ACCEPTED (201), not when the report completes. Runs a real Chromium browser (Playwright) against the page: Lighthouse (mobile lab metrics), rendered axe-core accessibility checks (WCAG 2.x A/AA tags), browser network/console evidence, screenshots, and passive security checks. Send an Idempotency-Key header so retries return the existing job (409 IDEMPOTENT_REPLAY, not charged) instead of purchasing a duplicate. Typical completion: tens of seconds to a few minutes; poll status_url.'
      parameters:
      - name: Idempotency-Key
        in: header
        required: false
        schema:
          type: string
        description: Strongly recommended. Same key + same body returns the existing job without a second charge; same key + different body is rejected (422 IDEMPOTENCY_KEY_REUSED).
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - url
              properties:
                url:
                  type: string
                  format: uri
                  description: Public HTTP/HTTPS page. Private-network/metadata targets rejected free of charge.
                devices:
                  type: array
                  items:
                    type: string
                    enum:
                    - mobile
                    - desktop
                  default:
                  - mobile
                modules:
                  type: array
                  items:
                    type: string
                    enum:
                    - lighthouse
                    - accessibility
                    - browser-network
                    - security-passive
                    - agent-readiness
                    - ai-summary
                artifacts:
                  type: object
                  properties:
                    screenshots:
                      type: boolean
                      default: true
                    lighthouse_json:
                      type: boolean
                      default: true
                    lighthouse_html:
                      type: boolean
                      default: false
      responses:
        '201':
          description: Job accepted and queued; payment settles on this response. Save access_token — it is shown only once.
          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
        '400':
          description: Invalid or blocked target/request (not charged).
          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
        '402':
          description: Payment required/invalid. Terms in the PAYMENT-REQUIRED header; body is an agent-readable hint.
        '409':
          description: 'Idempotent replay: the existing job for this Idempotency-Key (not charged).'
          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
        '422':
          description: Idempotency-Key reused with a different body.
          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
        '503':
          description: Deep tier not enabled or storage unavailable (not charged).
          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