AIWebSignals Readiness API
Bounded public AI web readiness scanning and reports.
Bounded public AI web readiness scanning and reports.
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/aiwebsignals-com:aiwebsignals-com-readiness-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: AIWebSignals Public Machine Readiness API
version: 2.1.9
description: Public, bounded AI web readiness and machine-discovery API. Paid account activation and autonomous machine payments are not part of this public contract.
servers:
- url: https://aiwebsignals.com
security: []
tags:
- name: Readiness
description: Bounded public AI web readiness scanning and reports.
paths:
/api/machine/scan:
get:
tags:
- Readiness
operationId: scanAiWebReadiness
summary: Run the bounded public AI web readiness scanner
parameters:
- name: domain
in: query
required: true
schema:
type: string
maxLength: 2048
description: Public hostname or http(s) URL. Private/local network targets are rejected by the scanner.
responses:
'200':
description: Normalized AI web signals
content:
application/json:
schema:
type: object
additionalProperties: true
'400':
description: Invalid or blocked target
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
error:
type: string
/report:
get:
tags:
- Readiness
operationId: getAiWebReadinessReport
summary: Get or run a normalized readiness report
parameters:
- name: domain
in: query
required: true
schema:
type: string
maxLength: 2048
responses:
'200':
description: Normalized report
content:
application/json:
schema:
type: object
additionalProperties: true
/history:
get:
tags:
- Readiness
operationId: getAiWebReadinessHistory
summary: Get exact-target scan history and change intelligence
parameters:
- name: domain
in: query
required: true
schema:
type: string
maxLength: 2048
- name: limit
in: query
required: false
schema:
type: integer
minimum: 1
maximum: 100
responses:
'200':
description: Scan history
content:
application/json:
schema:
type: object
additionalProperties: true
/api/machine/evaluate:
get:
tags:
- Readiness
operationId: evaluateAiWebReadinessOneCall
summary: Run a bounded public readiness scan and return verified matching normalized…
parameters:
- name: domain
in: query
required: true
schema:
type: string
maxLength: 253
description: Public hostname only (or https://hostname); private-network targets rejected
responses:
'200':
description: Completed matched scan/report evidence
'400':
description: Invalid public hostname
'422':
description: Evidence remains unavailable or insufficient
'502':
description: Scanner or persisted report integrity mismatch
/api/compare:
get:
tags:
- Readiness
operationId: comparePublicMachineWebEvidence
summary: Compare public technical readiness and evidence coverage across 2-6 domains
parameters:
- name: domains
in: query
required: true
schema:
type: string
maxLength: 1600
description: Comma-separated public hostnames. Unknown evidence remains unknown rather than zero.
responses:
'200':
description: Public evidence comparison matrix
content:
application/json:
schema:
type: object
additionalProperties: true
'400':
description: Invalid comparison request
x-aiwebsignals-contract-version: '1'
x-aiwebsignals-autonomous-machine-payment-active: false
x-aiwebsignals-a2a-agent-card-published: true
x-aiwebsignals-mcp-server-active: true
x-aiwebsignals-mcp-url: https://aiwebsignals.com/mcp
x-aiwebsignals-mcp-protocol-version: '2026-07-28'
x-aiwebsignals-mcp-legacy-stateless-fallback: true
x-aiwebsignals-a2a-server-active: true
x-aiwebsignals-a2a-url: https://aiwebsignals.com/a2a
x-aiwebsignals-a2a-agent-card-url: https://aiwebsignals.com/.well-known/agent-card.json
x-aiwebsignals-a2a-protocol-version: '1.0'
x-aiwebsignals-a2a-protocol-binding: JSONRPC