API
ClawdScore
Scanner API
Scan any URL for AI-readiness programmatically.
Scan a URL
GET
/api/scan?url=https://example.com
Returns an AI-readiness score (0–100), tier, and a breakdown of 8 factors that affect how discoverable your brand is by AI agents like ChatGPT, Claude, and Perplexity.
Parameters
| Name | Type | Description |
|---|---|---|
url |
string | The URL to scan (required). Must include protocol. |
Example Response
{
"url": "https://porelab.netlify.app",
"score": 85,
"tier": "gold",
"factors": [
{
"name": "Structured Data (Schema.org)",
"pass": true,
"score": 15,
"max": 15,
"detail": "JSON-LD markup helping AI understand your content"
},
{
"name": "XML Sitemap",
"pass": true,
"score": 10,
"max": 10,
"detail": "Makes pages discoverable by crawlers and AI agents"
}
// ... 6 more factors
],
"scannedAt": "2026-05-03T12:00:00Z"
}
Code Examples
cURL
curl "https://clawdscore.ai/api/scan?url=https://example.com"
Python
import requests
response = requests.get(
"https://clawdscore.ai/api/scan",
params={"url": "https://example.com"}
)
result = response.json()
print(f"Score: {result['score']}/100 — {result['tier'].upper()} tier")
JavaScript (fetch)
const res = await fetch(
'https://clawdscore.ai/api/scan?url=https://example.com'
);
const data = await res.json();
console.log(`Score: ${data.score}/100 — ${data.tier} tier`);
Agent-friendly: This API is designed to be called by AI agents too. Just send a GET request with a URL — no auth, no rate limiting on the free tier.