Public Score Pages

Every scanned domain gets a shareable score page at:

https://crawlready.app/score/{domain}

For example: https://crawlready.app/score/example.com

The page shows the AI Readiness Score, all three sub-scores, and the scan timestamp. No account is required to view it.

The badge

The badge endpoint returns an SVG image. Embed it anywhere an image tag is accepted.

GET https://crawlready.app/api/v1/badge/{domain}

Query parameters

| Parameter | Values | Default | Description | |---|---|---|---| | size | large, compact | large | Badge layout. large is a horizontal card (950×450 viewBox). compact is a square card (500×500 viewBox). |

The badge also accepts a .svg extension on the domain: /badge/example.com.svg is equivalent to /badge/example.com.

What the badge displays

Your AI Readiness Score (0–100)
A score band label (Critical / Poor / Fair / Good / Excellent)
Star rating (1–5) derived from the band
"VERIFIED BY CrawlReady.app" attribution
If no scan exists yet: a "Not Yet Scanned" placeholder

The badge is rate-limited at 1,000 requests per hour per IP and cached by CDN for one hour.

Embed in a README

[![AI Ready](https://crawlready.app/api/v1/badge/example.com)](https://crawlready.app/score/example.com)

For the compact badge:

[![AI Ready](https://crawlready.app/api/v1/badge/example.com?size=compact)](https://crawlready.app/score/example.com)

Embed on a website

<a href="https://crawlready.app/score/example.com" target="_blank" rel="noopener noreferrer">
  <img src="https://crawlready.app/api/v1/badge/example.com"
       alt="AI Readiness Score"
       style="max-width: 380px;">
</a>

For the compact badge:

<a href="https://crawlready.app/score/example.com" target="_blank" rel="noopener noreferrer">
  <img src="https://crawlready.app/api/v1/badge/example.com?size=compact"
       alt="AI Readiness Score"
       style="max-width: 200px;">
</a>

The SVG scales to any size — set width via CSS on the <img> tag rather than via SVG attributes.

Score API

To fetch score data programmatically, use the score endpoint:

GET https://crawlready.app/api/v1/score/{domain}

This returns JSON with the latest scan result for that domain: aiReadinessScore, all three sub-scores, recommendations, visual diff, EU AI Act checks, and the scan timestamp. See the API Reference for the full response schema.

Public Score Pages