开发者
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
}响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
| url | string | 经过重定向后的最终 URL |
| builder | string | null | 检测到的建站工具名称(如 Framer、Webflow、WordPress) |
| builderSlug | string | null | 建站工具的 slug 标识符 |
| confidence | "high" | "medium" | "low" | null | 检测置信度 |
| category | string | null | 建站工具类别(ai-builder、cms、ecommerce 等) |
| technologies | string[] | 检测到的技术和服务 |
| hosting | string | null | 检测到的托管商 |
| siteType | string | null | 网站类型(marketing、ecommerce、blog 等) |
| cached | boolean | 结果来自缓存时为 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"])需要更高的配额或有其他问题?联系我们 →