# CiteWin scoring methodology

> The public audit measures technical AI readiness on a 0-100 scale using evidence fetched from the submitted public website. A readiness score is separate from observed AI citations.

## What the audit checks

The audit inspects crawler access and robots.txt, discovery documents such as llms.txt, structured data and JSON-LD, and whether agents can read the site's content. Findings link to the evidence collected and recommend fixes.

| Category | Maximum points |
| --- | --- |
| Search crawler access | 25 |
| Structured data and entity schema | 20 |
| Agent discovery protocols | 15 |
| Server-rendered content | 15 |
| Facts and source grounding | 15 |
| Indexing signals | 10 |

These six categories total 100 points before deductions. Boilerplate can deduct 5 points, missing contact signals 5 points, and a JavaScript-only shell 10 points. These weights are CiteWin heuristics, not search engine ranking factors. Search crawlers and model-training crawlers are reported separately; blocking training alone does not mean a site cannot appear in search answers.

## Reading results

Use the score, individual check results and source evidence together. A failed fetch, blocked crawler or unavailable measurement is not proof of a citation gap. An incomplete audit must not be treated as a complete score. Reports can change as pages, crawler policies and audit checks change.

## Citation measurement

Citation observations require separate live queries to supported AI engines. Provider availability and prompt selection affect coverage. Technical readiness, search ranking and verified citation share measure different things. No audit guarantees a position or a citation in a third-party AI engine.

## Public API

POST https://api.citewin.com/api/v1/public/scan with Content-Type: application/json and body {"url":"https://example.com"}. No account or API key is required. The API allows 10 scans per IP per hour. A successful request returns HTTP 201 with the scan id, domain, url, readiness_score and top_fixes. GET https://api.citewin.com/api/v1/public/scan/{id} returns the public lead report with up to three verified issues; full details require sign-in. Handle 422 for invalid URLs, 429 for rate limits, 502 when scanning is unavailable and 409 when a report needs a fresh scan. Submit only public domains you intend to audit.

[Run an audit](https://citewin.com/audit). [Read pricing](https://citewin.com/pricing.md). Contact dhruvil@citewin.com with questions about a result.
