{"openapi":"3.0.3","info":{"title":"QVSO AI 可见性查询 API","version":"1.0.0","description":"AI 收录与可见性查询接口：对指定域名执行完整检测（爬虫可达性、AI 认知度、基础设施），返回综合报告 JSON。每 IP 限 10 次/小时，限流信息见 X-RateLimit-* 响应头。","contact":{"url":"https://qvso.com/developers"}},"servers":[{"url":"https://qvso.com"}],"paths":{"/api/v1/check":{"post":{"operationId":"checkSite","summary":"运行站点 AI 可见性检测","description":"对指定域名执行完整检测管线（约 40~100 秒）：robots/UA 模拟/llms.txt/Sitemap/页面可抓取性/联网检索/多平台 AI 认知实测/信源与关键词聚合/被引页面提取，返回综合报告与快照 ID。","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","description":"待检测域名或完整 URL，如 example.com 或 https://example.com"}}},"example":{"url":"example.com"}}}},"responses":{"200":{"description":"检测完成，返回完整报告","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","example":true},"report":{"type":"object","description":"SiteCheckReport 完整报告（评分/检测项/AI 认知/信源/关键词/被引页面等）"},"snapshotId":{"type":"string","nullable":true,"description":"快照 ID，可通过 /report/{snapshotId} 查看固定链接"}}}}}},"400":{"description":"url 缺失或格式非法"},"429":{"description":"超出限流（每 IP 10 次/小时）"}}}}}}