UFOlens API（v1）

唯讀 JSON API，回傳的是公有領域資料 + 本站的衍生加值（OCR／翻譯／結構化）。免費 tier 無需金鑰（IP 限流）；研究者 tier（免費金鑰、較高限額、需 attribution）與商用 tier 詳見下方。

端點

• GET https://www.ufolens.com/api/v1/docs?limit&offset&agency&type — 文件清單
• GET https://www.ufolens.com/api/v1/doc/{slug} — 單一文件 metadata + 區塊
• GET https://www.ufolens.com/api/v1/doc/{slug}/translations/{lang} — 某語言譯文
• GET https://www.ufolens.com/api/v1/doc/{slug}/ocr — 逐頁 OCR（含正規化 bbox）
• GET https://www.ufolens.com/api/v1/incidents?bbox=w,s,e,n&from&to — 地圖事件
• GET https://www.ufolens.com/api/v1/timeline — 時間軸資料
• GET https://www.ufolens.com/api/v1/search?q&lang — 全文檢索
• GET https://www.ufolens.com/api/v1/entities?kind&value — 實體查詢
• GET https://www.ufolens.com/api/v1/meta — 站台 metadata（已上線語言、最新 release…）

金鑰與限額

帶 ?key=... 或 Authorization: Bearer ...；free=30 req/min、researcher=300 req/min（需在回應與作品中標註來源）、commercial=自訂 + bulk export + 新 tranche webhook。申請：見頁尾聯絡方式。

服務條款（摘要）

• 須標註來源（war.gov/ufo + UFOlens.com）。
• 禁止冒充美國政府官方來源。
• 提醒：資料含官方遮蔽內容，請勿「還原」。
• 依美國法。

OpenAPI 規格：/api/v1/openapi.json