開發者

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"])

需要更高的配額或有其他問題?聯絡我們 →