{"openapi":"3.1.0","info":{"title":"Paradigma public tools API","version":"1","summary":"Free SEO, AEO, GEO and AI agent readiness scans of any public domain.","description":"One pillar per call, no sign-in and no API key. Each report lists every check with its status, evidence, sources and fix. The same scans are available as MCP tools at https://paradigma.click/api/tools/mcp and from the CLI: npx paradigma-cli check <pillar> <domain>.","termsOfService":"https://paradigma.click/terms","contact":{"name":"Paradigma","email":"support@paradigma.click"}},"externalDocs":{"description":"Developer docs","url":"https://paradigma.click/developers"},"servers":[{"url":"https://paradigma.click"}],"security":[],"tags":[{"name":"Scans","description":"Run or read a scan"},{"name":"Schema","description":"The report's JSON Schema"},{"name":"Penalty risk","description":"A private penalty risk check, one free use per 30 days"}],"paths":{"/api/tools/v1/risk/{domain}":{"get":{"operationId":"getPenaltyRisk","tags":["Penalty risk"],"summary":"Check one domain for penalty risk, privately","description":"Runs every static penalty risk check on a public domain and returns the result to the caller only: never cached, stored or linked. One free check per visitor every 30 days (hashed IP and a signed cookie). A signed-in member (session or CLI token) checking one of their own projects gets 30 per hour.","parameters":[{"$ref":"#/components/parameters/domain"}],"responses":{"200":{"description":"The private result: level, families found with evidence, pages, fix and policy, and the families checked.","headers":{"Cache-Control":{"description":"Always private, no-store","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PenaltyRiskResult"}}}},"400":{"description":"`invalid_domain`: not a public domain name","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RiskError"}}}},"422":{"description":"`not_public`: the domain resolves to a non-public address; `unreachable`: the site did not answer","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RiskError"}}}},"429":{"description":"`already_used`: the free check was used in the last 30 days; `rate_limited`: a member's hourly limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RiskError"}}},"headers":{"Retry-After":{"description":"Seconds until a new check is allowed","schema":{"type":"integer"}}}},"502":{"description":"`scan_failed`: the check failed, try again later","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RiskError"}}}}}}},"/api/tools/v1/{pillar}/{domain}":{"get":{"operationId":"getScan","tags":["Scans"],"summary":"Get the report for one pillar and domain","description":"Serves the cached report from the last 24 hours, or runs a static scan on a miss. New scans are limited to 10 per client IP per 60 minutes.","parameters":[{"$ref":"#/components/parameters/pillar"},{"$ref":"#/components/parameters/domain"}],"responses":{"200":{"description":"The report. `snapshot.cached` is true when it came from the cache.","headers":{"Cache-Control":{"description":"public, max-age=0, s-maxage=60 for a cached report, otherwise no-store","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReport"}}}},"400":{"description":"`invalid_domain`: not a public domain name","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScanError"}}}},"404":{"description":"`unknown_pillar`: the pillar is not one of the four","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScanError"}}}},"422":{"description":"`not_public`: the domain resolves to a non-public address; `unreachable`: the site did not answer","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScanError"}}}},"429":{"description":"`rate_limited`: too many new scans from this IP","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScanError"}}},"headers":{"Retry-After":{"description":"Seconds until a new scan is allowed","schema":{"type":"integer"}}}},"502":{"description":"`scan_failed`: the scan failed, try again later","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScanError"}}}}}},"post":{"operationId":"rescan","tags":["Scans"],"summary":"Rescan one pillar and domain","description":"Always runs a new scan. Limited to 1 rescan per domain and pillar every 10 minutes, plus the per-IP limit for new scans.","parameters":[{"$ref":"#/components/parameters/pillar"},{"$ref":"#/components/parameters/domain"}],"responses":{"200":{"description":"The new report.","headers":{"Cache-Control":{"description":"no-store","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReport"}}}},"400":{"description":"`invalid_domain`: not a public domain name","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScanError"}}}},"404":{"description":"`unknown_pillar`: the pillar is not one of the four","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScanError"}}}},"422":{"description":"`not_public`: the domain resolves to a non-public address; `unreachable`: the site did not answer","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScanError"}}}},"429":{"description":"`rate_limited` or `rescan_too_soon`: wait before scanning again","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScanError"}}},"headers":{"Retry-After":{"description":"Seconds until a new scan is allowed","schema":{"type":"integer"}}}},"502":{"description":"`scan_failed`: the scan failed, try again later","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScanError"}}}}}}},"/api/tools/v1/schema":{"get":{"operationId":"getSchema","tags":["Schema"],"summary":"JSON Schema of the report","responses":{"200":{"description":"JSON Schema (draft 2020-12) of the 200 answer","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"components":{"parameters":{"pillar":{"name":"pillar","in":"path","required":true,"description":"Which checker to run","schema":{"type":"string","enum":["seo","aeo","geo","agents"]}},"domain":{"name":"domain","in":"path","required":true,"description":"A public domain name such as example.com. IP addresses, ports, localhost and reserved names are refused.","schema":{"type":"string","examples":["example.com"]}}},"schemas":{"PublicReport":{"type":"object","properties":{"scoreContractVersion":{"type":"string","const":"1"},"generatedAt":{"type":"string"},"target":{"type":"object","properties":{"input":{"type":"string"},"origin":{"type":"string"},"host":{"type":"string"}},"required":["input","origin","host"],"additionalProperties":false},"siteType":{"type":"object","properties":{"type":{"type":"string","enum":["docs","business","app","commerce"]},"inferred":{"type":"boolean"},"defaulted":{"type":"boolean"},"scores":{"type":"object","propertyNames":{"type":"string","enum":["docs","business","app","commerce"]},"additionalProperties":{"type":"number"},"required":["docs","business","app","commerce"]},"evidence":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["docs","business","app","commerce"]},"signal":{"type":"string"},"points":{"type":"number"},"detail":{"type":"string"}},"required":["type","signal","points","detail"],"additionalProperties":false}}},"required":["type","inferred","defaulted","scores","evidence"],"additionalProperties":false},"scan":{"type":"object","properties":{"fetchedAt":{"type":"string"},"userAgent":{"type":"string"},"robots":{"type":"string","enum":["ok","missing","unreachable"]},"pagesSampled":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"pagesRead":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sitemaps":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"requests":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"durationMs":{"type":"number"},"capabilities":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"boolean"}},"warnings":{"type":"array","items":{"type":"string"}},"rendering":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"rendered":{"type":"boolean"},"reason":{"type":"string"},"durationMs":{"type":"number"}},"required":["url","rendered"],"additionalProperties":false}}},"required":["fetchedAt","userAgent","robots","pagesSampled","pagesRead","sitemaps","requests","durationMs","capabilities","warnings"],"additionalProperties":false},"pillars":{"minItems":1,"maxItems":1,"type":"array","items":{"type":"object","properties":{"pillar":{"type":"string","enum":["seo","aeo","geo","agents"]},"score":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"label":{"anyOf":[{"type":"string","enum":["Strong","Ready with gaps","Important blockers","Likely to struggle"]},{"type":"null"}]},"uncapped":{"type":["number","null"]},"pools":{"type":"object","properties":{"essential":{"type":"object","properties":{"earned":{"type":"number"},"max":{"type":"number"},"passed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"applicable":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["earned","max","passed","applicable"],"additionalProperties":false},"recommended":{"type":"object","properties":{"earned":{"type":"number"},"max":{"type":"number"},"passed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"applicable":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["earned","max","passed","applicable"],"additionalProperties":false},"bonus":{"type":"object","properties":{"earned":{"type":"number"},"cap":{"type":"number","const":5},"passed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"applicable":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["earned","cap","passed","applicable"],"additionalProperties":false}},"required":["essential","recommended","bonus"],"additionalProperties":false},"cap":{"anyOf":[{"type":"object","properties":{"at":{"type":"number"},"label":{"type":"string"},"checkIds":{"type":"array","items":{"type":"string"}}},"required":["at","label","checkIds"],"additionalProperties":false},{"type":"null"}]},"counts":{"type":"object","properties":{"checks":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"pass":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"partial":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"fail":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"na":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"suggestions":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["checks","pass","partial","fail","na","suggestions"],"additionalProperties":false},"layers":{"type":"array","items":{"type":"object","properties":{"layer":{"type":"string"},"passed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"applicable":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"checks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"oraId":{"type":"string"},"title":{"type":"string"},"whatItTests":{"type":"string"},"whySuggested":{"type":"string"},"layer":{"type":"string"},"pillars":{"type":"array","items":{"type":"string","enum":["seo","aeo","geo","agents"]}},"tier":{"type":"string","enum":["essential","recommended","bonus","suggestion"]},"evidenceLevel":{"type":"string","enum":["requirement","documented","observed","common-practice"]},"scope":{"type":"string","enum":["page","site"]},"gate":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"}},"required":["title","url"],"additionalProperties":false}},"status":{"type":"string","enum":["pass","partial","fail","na"]},"fraction":{"type":"number","minimum":0,"maximum":1},"credit":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"summary":{"type":"string"},"review":{"type":"boolean"},"naReason":{"type":"string"},"evidence":{"type":"array","items":{"type":"object","properties":{"request":{"type":"object","properties":{"method":{"type":"string","const":"GET"},"url":{"type":"string"},"accept":{"type":"string"},"agent":{"type":"string"}},"required":["method","url"],"additionalProperties":false},"response":{"type":"object","properties":{"status":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"headers":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"bodyExcerpt":{"type":"string","maxLength":400},"timingMs":{"type":"number"},"redirects":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"status":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["url","status"],"additionalProperties":false}},"error":{"type":"string"}},"required":["status"],"additionalProperties":false},"steps":{"type":"array","items":{"type":"string"}},"conclusion":{"type":"string"}},"required":["conclusion"],"additionalProperties":false}},"pages":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"status":{"type":"string","enum":["pass","partial","fail"]},"note":{"type":"string"}},"required":["url","status"],"additionalProperties":false}},"fix":{"type":"object","properties":{"copy":{"type":"string"},"prompt":{"type":"string"},"pr":{"type":"string","enum":["auto","draft","none"]}},"required":["copy","prompt","pr"],"additionalProperties":false}},"required":["id","title","layer","pillars","tier","evidenceLevel","scope","sources","status","credit","summary","review","evidence"],"additionalProperties":false}}},"required":["layer","passed","applicable","checks"],"additionalProperties":false}},"suggestions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"oraId":{"type":"string"},"title":{"type":"string"},"whatItTests":{"type":"string"},"whySuggested":{"type":"string"},"layer":{"type":"string"},"pillars":{"type":"array","items":{"type":"string","enum":["seo","aeo","geo","agents"]}},"tier":{"type":"string","enum":["essential","recommended","bonus","suggestion"]},"evidenceLevel":{"type":"string","enum":["requirement","documented","observed","common-practice"]},"scope":{"type":"string","enum":["page","site"]},"gate":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"}},"required":["title","url"],"additionalProperties":false}},"status":{"type":"string","enum":["pass","partial","fail","na"]},"fraction":{"type":"number","minimum":0,"maximum":1},"credit":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"summary":{"type":"string"},"review":{"type":"boolean"},"naReason":{"type":"string"},"evidence":{"type":"array","items":{"type":"object","properties":{"request":{"type":"object","properties":{"method":{"type":"string","const":"GET"},"url":{"type":"string"},"accept":{"type":"string"},"agent":{"type":"string"}},"required":["method","url"],"additionalProperties":false},"response":{"type":"object","properties":{"status":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"headers":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"bodyExcerpt":{"type":"string","maxLength":400},"timingMs":{"type":"number"},"redirects":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"status":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["url","status"],"additionalProperties":false}},"error":{"type":"string"}},"required":["status"],"additionalProperties":false},"steps":{"type":"array","items":{"type":"string"}},"conclusion":{"type":"string"}},"required":["conclusion"],"additionalProperties":false}},"pages":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"status":{"type":"string","enum":["pass","partial","fail"]},"note":{"type":"string"}},"required":["url","status"],"additionalProperties":false}},"fix":{"type":"object","properties":{"copy":{"type":"string"},"prompt":{"type":"string"},"pr":{"type":"string","enum":["auto","draft","none"]}},"required":["copy","prompt","pr"],"additionalProperties":false}},"required":["id","title","layer","pillars","tier","evidenceLevel","scope","sources","status","credit","summary","review","evidence"],"additionalProperties":false}},"fixFirst":{"type":"array","items":{"type":"object","properties":{"checkId":{"type":"string"},"title":{"type":"string"},"pillars":{"type":"array","items":{"type":"string","enum":["seo","aeo","geo","agents"]}},"tier":{"type":"string","enum":["essential","recommended","bonus","suggestion"]},"status":{"type":"string","enum":["fail","partial"]},"summary":{"type":"string"},"reach":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"gate":{"type":"boolean"},"fix":{"type":"object","properties":{"copy":{"type":"string"},"prompt":{"type":"string"},"pr":{"type":"string","enum":["auto","draft","none"]}},"required":["copy","prompt","pr"],"additionalProperties":false}},"required":["checkId","title","pillars","tier","status","summary","reach","gate"],"additionalProperties":false}},"measured":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"oraId":{"type":"string"},"title":{"type":"string"},"whatItTests":{"type":"string"},"whySuggested":{"type":"string"},"layer":{"type":"string"},"pillars":{"type":"array","items":{"type":"string","enum":["seo","aeo","geo","agents"]}},"tier":{"type":"string","enum":["essential","recommended","bonus","suggestion"]},"evidenceLevel":{"type":"string","enum":["requirement","documented","observed","common-practice"]},"scope":{"type":"string","enum":["page","site"]},"gate":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"}},"required":["title","url"],"additionalProperties":false}},"status":{"type":"string","enum":["pass","partial","fail","na"]},"fraction":{"type":"number","minimum":0,"maximum":1},"credit":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"summary":{"type":"string"},"review":{"type":"boolean"},"naReason":{"type":"string"},"evidence":{"type":"array","items":{"type":"object","properties":{"request":{"type":"object","properties":{"method":{"type":"string","const":"GET"},"url":{"type":"string"},"accept":{"type":"string"},"agent":{"type":"string"}},"required":["method","url"],"additionalProperties":false},"response":{"type":"object","properties":{"status":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"headers":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"bodyExcerpt":{"type":"string","maxLength":400},"timingMs":{"type":"number"},"redirects":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"status":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["url","status"],"additionalProperties":false}},"error":{"type":"string"}},"required":["status"],"additionalProperties":false},"steps":{"type":"array","items":{"type":"string"}},"conclusion":{"type":"string"}},"required":["conclusion"],"additionalProperties":false}},"pages":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"status":{"type":"string","enum":["pass","partial","fail"]},"note":{"type":"string"}},"required":["url","status"],"additionalProperties":false}},"fix":{"type":"object","properties":{"copy":{"type":"string"},"prompt":{"type":"string"},"pr":{"type":"string","enum":["auto","draft","none"]}},"required":["copy","prompt","pr"],"additionalProperties":false}},"required":["id","title","layer","pillars","tier","evidenceLevel","scope","sources","status","credit","summary","review","evidence"],"additionalProperties":false}},"lighthouse":{"type":"object","properties":{"version":{"type":"string"},"score":{"anyOf":[{"type":"integer","minimum":0,"maximum":100},{"type":"null"}]},"audits":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"checkId":{"type":["string","null"]},"title":{"type":"string"},"weight":{"type":"number"},"group":{"type":"string","enum":["seo-crawl","seo-content","manual"]},"score":{"anyOf":[{"anyOf":[{"type":"number","const":0},{"type":"number","const":1}]},{"type":"null"}]},"mode":{"type":"string","enum":["binary","notApplicable","manual"]}},"required":["id","checkId","title","weight","group","score","mode"],"additionalProperties":false}}},"required":["version","score","audits"],"additionalProperties":false},"beyond":{"type":"object","properties":{"score":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"label":{"anyOf":[{"type":"string","enum":["Strong","Ready with gaps","Important blockers","Likely to struggle"]},{"type":"null"}]},"uncapped":{"type":["number","null"]},"pools":{"type":"object","properties":{"essential":{"type":"object","properties":{"earned":{"type":"number"},"max":{"type":"number"},"passed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"applicable":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["earned","max","passed","applicable"],"additionalProperties":false},"recommended":{"type":"object","properties":{"earned":{"type":"number"},"max":{"type":"number"},"passed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"applicable":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["earned","max","passed","applicable"],"additionalProperties":false},"bonus":{"type":"object","properties":{"earned":{"type":"number"},"cap":{"type":"number","const":5},"passed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"applicable":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["earned","cap","passed","applicable"],"additionalProperties":false}},"required":["essential","recommended","bonus"],"additionalProperties":false},"cap":{"anyOf":[{"type":"object","properties":{"at":{"type":"number"},"label":{"type":"string"},"checkIds":{"type":"array","items":{"type":"string"}}},"required":["at","label","checkIds"],"additionalProperties":false},{"type":"null"}]}},"required":["score","label","uncapped","pools","cap"],"additionalProperties":false}},"required":["pillar","score","label","uncapped","pools","cap","counts","layers","suggestions","fixFirst"],"additionalProperties":false}},"fixFirst":{"type":"array","items":{"type":"object","properties":{"checkId":{"type":"string"},"title":{"type":"string"},"pillars":{"type":"array","items":{"type":"string","enum":["seo","aeo","geo","agents"]}},"tier":{"type":"string","enum":["essential","recommended","bonus","suggestion"]},"status":{"type":"string","enum":["fail","partial"]},"summary":{"type":"string"},"reach":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"gate":{"type":"boolean"},"fix":{"type":"object","properties":{"copy":{"type":"string"},"prompt":{"type":"string"},"pr":{"type":"string","enum":["auto","draft","none"]}},"required":["copy","prompt","pr"],"additionalProperties":false}},"required":["checkId","title","pillars","tier","status","summary","reach","gate"],"additionalProperties":false}},"risks":{"type":"object","properties":{"level":{"type":"string","enum":["none","low","elevated","high"]},"families":{"type":"array","items":{"type":"object","properties":{"family":{"type":"string","enum":["scaled-content","templated-pages","locale-hygiene","machine-output","brand-confusion","cloaking","ai-manipulation","sneaky-redirect","structured-data-spam","fake-freshness","copilot-directives","link-qualification","hidden-text","keyword-stuffing","back-button-hijack","interstitials","hacked-content","crawl-stall"]},"channels":{"type":"array","items":{"type":"string","enum":["google","bing","ai","browsers","social"]}},"documented":{"type":"boolean"},"policyUrl":{"type":"string"},"status":{"type":"string","enum":["fail","partial"]},"worst":{"type":"string","enum":["low","elevated","high"]},"review":{"type":"boolean"},"checkIds":{"type":"array","items":{"type":"string"}},"pages":{"type":"array","items":{"type":"string"}}},"required":["family","channels","documented","policyUrl","status","worst","review","checkIds","pages"],"additionalProperties":false}}},"required":["level","families"],"additionalProperties":false},"teaser":{"type":"array","items":{"type":"object","properties":{"pillar":{"type":"string","enum":["seo","aeo","geo","agents"]},"issues":{"type":"integer","minimum":0,"maximum":9007199254740991},"checks":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["pillar","issues","checks"],"additionalProperties":false}},"riskSignals":{"type":"integer","minimum":0,"maximum":9007199254740991},"tool":{"type":"object","properties":{"pillar":{"type":"string","enum":["seo","aeo","geo","agents"]},"name":{"type":"string"},"url":{"type":"string"},"resultUrl":{"type":"string"},"badgeUrl":{"type":"string"},"methodologyUrl":{"type":"string"}},"required":["pillar","name","url","resultUrl","badgeUrl","methodologyUrl"],"additionalProperties":false},"snapshot":{"type":"object","properties":{"scannedAt":{"type":"string"},"expiresAt":{"type":"string"},"cached":{"type":"boolean"}},"required":["scannedAt","expiresAt","cached"],"additionalProperties":false}},"required":["scoreContractVersion","generatedAt","target","siteType","scan","pillars","fixFirst","teaser","tool","snapshot"],"additionalProperties":false,"title":"Paradigma public scan, one pillar, score contract v1"},"PenaltyRiskResult":{"type":"object","properties":{"kind":{"type":"string","const":"penalty-risk"},"target":{"type":"object","properties":{"host":{"type":"string"},"origin":{"type":"string"}},"required":["host","origin"],"additionalProperties":false},"scannedAt":{"type":"string"},"level":{"type":"string","enum":["none","low","elevated","high"]},"found":{"type":"array","items":{"type":"object","properties":{"family":{"type":"string","enum":["scaled-content","templated-pages","locale-hygiene","machine-output","brand-confusion","cloaking","ai-manipulation","sneaky-redirect","structured-data-spam","fake-freshness","copilot-directives","link-qualification","hidden-text","keyword-stuffing","back-button-hijack","interstitials","hacked-content","crawl-stall"]},"label":{"type":"string"},"level":{"type":"string","enum":["low","elevated","high"]},"channels":{"type":"array","items":{"type":"string","enum":["google","bing","ai","browsers","social"]}},"documented":{"type":"boolean"},"policyUrl":{"type":"string"},"findings":{"type":"array","items":{"type":"object","properties":{"check":{"type":"string"},"evidence":{"type":"string"},"fix":{"type":["string","null"]},"prompt":{"type":["string","null"]},"pages":{"type":"array","items":{"type":"string"}},"siteWide":{"type":"boolean"}},"required":["check","evidence","fix","prompt","pages","siteWide"],"additionalProperties":false}},"pages":{"type":"array","items":{"type":"string"}}},"required":["family","label","level","channels","documented","policyUrl","findings","pages"],"additionalProperties":false}},"clean":{"type":"array","items":{"type":"object","properties":{"family":{"type":"string","enum":["scaled-content","templated-pages","locale-hygiene","machine-output","brand-confusion","cloaking","ai-manipulation","sneaky-redirect","structured-data-spam","fake-freshness","copilot-directives","link-qualification","hidden-text","keyword-stuffing","back-button-hijack","interstitials","hacked-content","crawl-stall"]},"label":{"type":"string"},"checked":{"type":"array","items":{"type":"string"}}},"required":["family","label","checked"],"additionalProperties":false}},"notChecked":{"type":"array","items":{"type":"object","properties":{"family":{"type":"string","enum":["scaled-content","templated-pages","locale-hygiene","machine-output","brand-confusion","cloaking","ai-manipulation","sneaky-redirect","structured-data-spam","fake-freshness","copilot-directives","link-qualification","hidden-text","keyword-stuffing","back-button-hijack","interstitials","hacked-content","crawl-stall"]},"label":{"type":"string"}},"required":["family","label"],"additionalProperties":false}},"scan":{"type":"object","properties":{"pagesRead":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"requests":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["pagesRead","requests"],"additionalProperties":false},"tool":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string"},"methodologyUrl":{"type":"string"},"signUpUrl":{"type":"string"},"manualActionsUrl":{"type":"string"}},"required":["name","url","methodologyUrl","signUpUrl","manualActionsUrl"],"additionalProperties":false},"private":{"type":"boolean","const":true}},"required":["kind","target","scannedAt","level","found","clean","notChecked","scan","tool","private"],"additionalProperties":false,"title":"Paradigma penalty risk check, private result"},"RiskError":{"type":"object","required":["ok","error","message"],"properties":{"ok":{"const":false},"error":{"type":"string","enum":["invalid_domain","not_public","unreachable","already_used","rate_limited","scan_failed"]},"message":{"type":"string"},"retryAfterSeconds":{"type":"integer"},"resetsAt":{"type":"string","format":"date-time"},"domain":{"type":"string"}}},"ScanError":{"type":"object","required":["ok","error","message"],"properties":{"ok":{"const":false},"error":{"type":"string","enum":["unknown_pillar","invalid_domain","not_public","unreachable","rate_limited","rescan_too_soon","scan_failed"]},"message":{"type":"string"},"retryAfterSeconds":{"type":"integer"},"resetsAt":{"type":"string","format":"date-time"},"domain":{"type":"string"}}}}}}