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.