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.
openapi: 3.2.0
info:
title: AgentReady public Verify API
version: 1.0.0
summary: 'Free AI sales-visibility scanner: score any website 0–100 on how discoverable and parseable it is for AI shopping agents.'
description: 'AgentReady''s free public endpoints — no signup, no API key, CORS-open.
- `GET /api/scan` — instant agent-readiness scan of any website: robots.txt access for the major AI crawlers (GPTBot, OAI-SearchBot, ChatGPT-User, ClaudeBot, Claude-User, PerplexityBot, Google-Extended), llms.txt and agents.md presence, schema.org JSON-LD structured data (Product, Offer, Organization, FAQPage), sitemap discoverability and answer-readiness metadata — returned as a 0–100 score with itemized checks and concrete fixes.
- `GET /api/verify/status` — public verification status of an Agent-Ready Verified badge (no PII exposed).
- `GET /badge/{id}.svg` — the embeddable Agent-Ready Verified badge image, kept honest by weekly automated re-verification.
Please self-limit to a few requests per minute per target. A pay-per-call version of the scan for autonomous agents (x402 protocol, USDC on Base, no account) is documented at https://x402.agiscorecard.com/openapi.json.'
contact:
name: AgentReady
url: https://agentready.agiscorecard.com/
license:
name: Proprietary — free public API, fair-use rate limits apply
url: https://agentready.agiscorecard.com/terms
servers:
- url: https://agentready.agiscorecard.com
security:
- {}
tags:
- name: Verify
paths:
/api/verify/status:
get:
operationId: verifyStatus
summary: Public Agent-Ready Verified badge status
description: 'Public verification status for a badge id: current score, grade, whether the badge is paid and actively passing its weekly re-verification. Exposes no email or token.'
parameters:
- name: id
in: query
required: true
description: Badge/verification id (as found in the badge URL `/badge/{id}.svg`).
schema:
type: string
responses:
'200':
description: Verification record.
content:
application/json:
schema:
$ref: '#/components/schemas/VerifyStatus'
'400':
description: Missing id parameter.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: No verification record for this id.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
tags:
- Verify
components:
schemas:
Error:
type: object
required:
- error
properties:
error:
type: string
description: Human- and agent-readable error message.
VerifyStatus:
type: object
properties:
url:
type: string
format: uri
description: The verified site.
score:
type: integer
minimum: 0
maximum: 100
grade:
type: string
verified:
type: boolean
description: True when the badge is paid AND currently passing re-verification.
paid:
type: boolean
active:
type: boolean
description: True when the last re-scan met the verification threshold.
createdAt:
type: string
format: date-time
lastVer: {}