開發者
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"])需要更高的配額或有其他問題?聯絡我們 →