Public score pages#
Every scanned domain gets a shareable score page at:
https://www.crawlready.app/score/{domain}
For example: https://www.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://www.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#
[](https://www.crawlready.app/score/example.com)
For the compact badge:
[](https://www.crawlready.app/score/example.com)
Embed on a website#
<a href="https://www.crawlready.app/score/example.com" target="_blank" rel="noopener noreferrer">
<img src="https://www.crawlready.app/api/v1/badge/example.com"
alt="AI Readiness Score"
style="max-width: 380px;">
</a>
For the compact badge:
<a href="https://www.crawlready.app/score/example.com" target="_blank" rel="noopener noreferrer">
<img src="https://www.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://www.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.
Frequently Asked Questions
Do I need an account to view a public score page?
No. Every scanned domain gets a shareable score page at crawlready.app/score/{domain} showing the AI Readiness Score, all three sub-scores, and the scan timestamp, and no account is required to view it.
What does the AI Readiness badge display?
The badge shows the AI Readiness Score (0-100), a score band label (Critical / Poor / Fair / Good / Excellent), a star rating from 1-5 derived from the band, and a 'VERIFIED BY CrawlReady.app' attribution. If no scan exists yet, it shows a 'Not Yet Scanned' placeholder instead.
How do I embed the badge in a README or on a website?
For a README, wrap the badge image URL in a markdown link pointing to the score page. For a website, use an <a> tag linking to the score page around an <img> tag pointing to the badge endpoint. The badge accepts a size query parameter — large (the default, a horizontal card) or compact (a square card) — and the SVG scales to any size, so set width via CSS on the img tag.
Is the AI Readiness badge rate-limited?
Yes. The badge is rate-limited at 1,000 requests per hour per IP and cached by CDN for one hour.
