API 文档 | SEO智检

概述

SEO智检提供 RESTful API，允许你以编程方式执行网站审计。API 基于 HTTPS，返回 JSON 格式数据。

审计接口

POST /api/v2/audit

请求参数

{
  "url": "https://example.com",
  "coverage": "standard"  // quick | standard | deep
}

响应格式

{
  "id": "uuid",
  "url": "https://example.com",
  "status": "completed",
  "triScore": {
    "total": 72,
    "grade": "B",
    "seo": { "layer": "seo", "score": 75, "weight": 0.4, "modules": [...] },
    "geo": { "layer": "geo", "score": 68, "weight": 0.35, "modules": [...] },
    "ux": { "layer": "ux", "score": 74, "weight": 0.25, "modules": [...] }
  },
  "issues": [
    {
      "id": "seo-missing-title",
      "module": "technical-seo",
      "layer": "seo",
      "severity": "critical",
      "title": "缺少 Title 标签",
      "description": "...",
      "recommendation": "..."
    }
  ],
  "duration": 12345,
  "createdAt": "2026-05-01T00:00:00Z"
}

内容评分接口

POST /api/v2/tools/content-score

{
  "url": "https://example.com/blog/post"
}

返回内容质量评分、关键词密度分析和 AI 可引用性评分。

速率限制

免费用户：每分钟 5 次请求。付费用户：每分钟 30 次请求。超出限制返回 429 状态码。

错误处理

API 使用标准 HTTP 状态码：

200 — 成功
400 — 请求参数错误
429 — 请求过于频繁
500 — 服务器内部错误

⚡ API 文档

概述