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 Badge 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: Badge
paths:
/badge/{id}.svg:
get:
operationId: badgeSvg
summary: Embeddable Agent-Ready Verified badge (SVG)
description: The live badge image for a verification id. Renders "verified" (paid + passing), "check failing" (paid but currently regressed), "preview" (eligible, unpaid) or "unverified" (unknown id). Cacheable for 1 hour; CORS-open, safe to hot-link from any site.
parameters:
- name: id
in: path
required: true
description: Badge/verification id.
schema:
type: string
responses:
'200':
description: SVG badge image (always 200 — unknown ids render the "unverified" badge).
content:
image/svg+xml:
schema:
type: string
description: SVG markup.
tags:
- Badge