开发者

API 文档

以编程方式检测任意 URL 的 AI 建站工具、技术栈、托管商和置信度评分。

基础 URLhttps://www.aiwebsitedetector.com/api/v1
形式JSON
认证API 密钥(Bearer / 请求头)

身份认证

每个请求都必须携带 API 密钥,可以通过以下两种方式传递:

方式 A — Authorization 请求头

Authorization: Bearer YOUR_API_KEY

方式 B — X-Api-Key 请求头

X-Api-Key: YOUR_API_KEY

公开注册暂未开放,API 密钥按申请发放 — 请联系我们,说明你的使用场景和预计调用量。

接口

POSTGET/api/v1/scan检测网站

扫描 URL,返回检测到的建站工具、技术栈、托管商和置信度评分。结果缓存 1 小时,期间对同一 URL 的请求会立即返回。

请求体(POST)

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

查询参数(GET)

GET /api/v1/scan?url=https://example.com

示例 — cURL

curl -X POST https://www.aiwebsitedetector.com/api/v1/scan \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://framer.com"}'

响应

{
  "url":          "https://framer.com",
  "builder":      "Framer",
  "builderSlug":  "framer",
  "confidence":   "high",
  "category":     "website-builder",
  "isAiNative":   true,
  "technologies": ["React", "Framer Motion", "Cloudflare"],
  "hosting":      "Framer",
  "siteType":     "marketing",
  "cached":       false
}

响应字段

字段类型说明
urlstring经过重定向后的最终 URL
builderstring | null检测到的建站工具名称(如 Framer、Webflow、WordPress)
builderSlugstring | null建站工具的 slug 标识符
confidence"high" | "medium" | "low" | null检测置信度
categorystring | null建站工具类别(ai-builder、cms、ecommerce 等)
technologiesstring[]检测到的技术和服务
hostingstring | null检测到的托管商
siteTypestring | null网站类型(marketing、ecommerce、blog 等)
cachedboolean结果来自缓存时为 true
GET/api/v1/meAPI 密钥信息与用量

返回你的 API 密钥详情、当前用量以及本计费月的剩余配额。

示例 — cURL

curl https://www.aiwebsitedetector.com/api/v1/me \
  -H "Authorization: Bearer YOUR_API_KEY"

响应

{
  "name":                "My App",
  "email":               "you@example.com",
  "plan":                "starter",
  "requests_used":       42,
  "requests_limit":      1000,
  "requests_remaining":  958,
  "resets_on":           "2026-04-01",
  "last_used_at":        "2026-03-27T10:30:00.000Z",
  "created_at":          "2026-03-01T00:00:00.000Z"
}

速率限制

每分钟限额

10–120

每个密钥每分钟请求数,按套餐而定(Free 10 · Starter 30 · Pro 60 · Advanced 120)

每月限额

按套餐

每月 1 日重置

每个响应都包含速率限制相关的响应头:

X-RateLimit-Limit: 30
X-RateLimit-Remaining: 28
X-RateLimit-Reset: 1743084060
Retry-After: 60   # only on 429 responses

超出每分钟限额时,你会收到 429 Too Many Requests 响应。超出每月配额时,在下次重置之前同样会收到 429。而 401 始终表示密钥本身缺失或无效,与配额无关。

错误码

状态含义
200成功
400请求错误 — 缺少 url 参数或参数无效
401未授权 — API 密钥缺失、无效或已被撤销
429超出速率限制 — 请降低请求频率或检查每月配额
500服务器错误 — 扫描失败(请重试)
503服务不可用 — 正在维护或 API 访问已禁用

所有错误响应都包含一个 error 字段,附带易读的错误说明。

代码示例

Node.js / fetch

const res = await fetch("https://www.aiwebsitedetector.com/api/v1/scan", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ url: "https://example.com" }),
});
const data = await res.json();
console.log(data.builder, data.confidence);

Python

import requests

response = requests.post(
    "https://www.aiwebsitedetector.com/api/v1/scan",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"url": "https://example.com"},
)
data = response.json()
print(data["builder"], data["confidence"])

需要更高的配额或有其他问题?联系我们 →