API 參考

具版本控制的唯讀公開資料 API

用於公共政策中繼資料的引用與查詢端點。每個 JSON 端點均以版本化方式置於 /api/public/v1.

API 回傳的內容

唯讀追蹤器元資料：標準記錄 URL、公開 JSON、審查狀態、證據欄位、來源連結與引用欄位。

API 不會做的事項

它不會修改紀錄、發布暫存執行結果、繞過審查狀態，也不會取代大學官方政策來源。

建議的檢索方式

利用搜尋或實體別名進行解析，擷取該大學記錄，隨後附加主張證據與來源 URL 以提供主張層級的回答。

用於有來源依據的摘要、公開 JSON、引註元資料、審閱狀態及官方來源連結。
以大學官方頁面作為政策用語的權威依據。
請勿將分析視為建議、安全指引或合規依據。
別名比對、主題與涵蓋分數並不會產生事實。
工具紀錄衍生自主張與證據文字；不能取代大學官方來源的措辭。

解析實體

通話 /api/public/v1/search.json?q=... 或檢查 /api/public/v1/entities/index.json 用於找到標準大學代號（slug）。別名比對可提高召回率，但不會產生事實。

Step1

開啟標準記錄

擷取 /api/public/v1/universities/{slug}.json 並在答案中保留規範頁面 URL、公開 JSON URL、檢視狀態、最後檢查日期、限制條件以及引用欄位。

Step2

附加主張證據

擷取 /api/public/v1/claims/{slug}.json 當需要以聲明為層級進行重複使用時。請保留來源網址、來源語言、證據片段、快照雜湊值、信賴度與審查狀態。

Step3

使用分析作為推導元資料

擷取 /api/public/v1/analysis/universities/{slug}.json 僅作為確定性衍生詮釋資料。非空分析維度務必引用基礎主張 ID 與來源 URL。

Step4

Discovery

公開 API 索引，附端點連結、可信度頁面、引用規則、限制及版本中繼資料。

GET/api/public/v1/index.jsonRead-only

大學

公開大學紀錄清單，包含標準頁面 URL、公開 JSON URL、審核狀態、日期及數量。

GET/api/public/v1/universities.jsonRead-only

實體搜尋

依標準名稱、別名、官方來源標題、主張摘要、來源網域或分析維度搜尋公開大學紀錄。

GET/api/public/v1/search.json?q={query}Read-only

安全搜尋索引

適用於 Pagefind 的公開搜尋索引，排除原始來源快照、私人檔案、尚未正式發布的暫存證據及非權威試算表資料列。

GET/api/public/v1/search/index.jsonRead-only

實體解析索引

用於提高召回率的標準大學實體別名。別名比對不會建立公開政策事實。

GET/api/public/v1/entities/index.jsonRead-only

大學記錄

一筆可供引用的大學紀錄，包含主張、證據摘錄、來源 URL、信心水準、審核狀態及權利注意事項。

GET/api/public/v1/universities/{slug}.jsonRead-only

大學主張

單筆公開大學紀錄的主張／證據資料列，包含來源 URL、來源語言、快照雜湊值、信心水準及審核狀態。

GET/api/public/v1/claims/{slug}.jsonRead-only

AI 工具目錄

衍生的大學 AI 工具紀錄，包含各工具的可用性、背書類型、審核狀態及證據摘錄。工具紀錄是探索用中繼資料，並非官方政策結論。

GET/api/public/v1/tools.jsonRead-only

近期變更

近期公開來源查核及已變更的院校紀錄。

GET/api/public/v1/recent-changes.jsonRead-only

分析 API 索引

確定性的政策分析維度、端點路徑、限制及結構版本中繼資料。

GET/api/public/v1/analysis/index.jsonRead-only

大學分析檔案

有來源依據的分析檔案，包含維度、證據主張 ID、來源 URL、信心水準、審核狀態及政策涵蓋分數。

GET/api/public/v1/analysis/universities/{slug}.jsonRead-only

政策涵蓋分數

公開分析檔案的覆蓋分數清單。分數衡量的是有來源支持的公開覆蓋廣度，而非政策品質。

GET/api/public/v1/analysis/coverage-scores.jsonRead-only

分析頁面品質

公開分析頁面的唯讀頁面品質關卡、可索引狀態、分析審查流程，以及不提供建議的界限。

GET/api/public/v1/analysis/page-quality.jsonRead-only

QS 2026 覆蓋範圍

QS 2026 目標的蒐集涵蓋資料列，含公開、僅暫存、缺漏、來源數、審核狀態及下一步行動欄位。

GET/api/public/v1/coverage/qs-2026.jsonRead-only

來源狀態

已正式發布的公開來源快照及暫存執行的來源／擷取健康中繼資料。用於修復規劃，不用於主張發布。

GET/api/public/v1/source-health.jsonRead-only

審查佇列

尚未正式發布的暫存執行中繼資料，包含驗證狀態、來源廣度、偵測到的網址代稱及建議的下一步行動。

GET/api/public/v1/review/queue.jsonRead-only

資料集釋出

發布清單，包含產物、資料列數、位元組大小、SHA-256 校驗碼、引用及限制。

GET/api/public/v1/datasets/latest.jsonRead-only

報告索引

機器可讀報告索引，包含報告網址、指標、資料連結、資料訂閱來源，以及外展探索。

GET/api/public/v1/reports/index.jsonRead-only

報告圖表資料

最新月報中可直接繪圖的來源語言、審核狀態、區域涵蓋、城市／校區涵蓋及排名涵蓋分布。

GET/api/public/v1/reports/monthly/2026-09/chart-data.jsonRead-only

報告推廣套件

機器可讀的媒體、電子報、研究者電子郵件及社群文案，明列使用界線。

GET/api/public/v1/reports/outreach.jsonRead-only

小工具索引

小工具探索資料，包含指令碼 URL、支援的小工具、限制及 HTML 範例。

GET/api/public/v1/widgets/index.jsonRead-only

大學狀態小工具

精簡的小工具資料，包含資料新近度、審核狀態、主張／來源數及標準連結。

GET/api/public/v1/widgets/university-status/{slug}.jsonRead-only

近期變更小工具

供公開來源查核及變更小工具使用的精簡近期變更資料。

GET/api/public/v1/widgets/recent-changes.jsonRead-only

政策覆蓋小工具

精簡且有來源依據的政策涵蓋小工具資料。涵蓋程度代表廣度，不代表政策品質。

GET/api/public/v1/widgets/policy-coverage/{slug}.jsonRead-only

來源即時性小工具

精簡的來源新近度小工具資料，包含上次查核日期、來源數及公開來源健康計數。

GET/api/public/v1/widgets/source-freshness/{slug}.jsonRead-only

審查狀態小工具

精簡的審核狀態小工具資料，包含信心水準、已審核主張及候選主張數。

GET/api/public/v1/widgets/review-state/{slug}.jsonRead-only

MCP alpha 清單

唯讀 MCP 設計清單，包含允許的工具形式、禁止的操作及代理查詢範例。

GET/api/public/v1/mcp/manifest.jsonRead-only

MCP 工具目錄

唯讀 MCP alpha 工具目錄，包含輸入結構、必要輸出欄位及嚴禁的變更操作。

GET/api/public/v1/mcp/tool-catalog.jsonRead-only

速率限制政策

機器可讀的公開合理使用政策，適用於 API、小工具及爬蟲存取。

GET/api/public/v1/rate-limit-policy.jsonRead-only

引註詮釋資料

機器可讀的引用範本、必要欄位、證據規則、來源權利注意事項及不提供建議的界線。

GET/api/public/v1/citation.jsonRead-only

貢獻指數

唯讀貢獻流程中繼資料、GitHub 議題範本 URL、防護措施及發布規則。

GET/api/public/v1/contributions/index.jsonRead-only

貢獻審核政策

唯讀審核佇列定義、內容管理界線及發布關卡。

GET/api/public/v1/contributions/review-policy.jsonRead-only

同時引用標準頁面 URL 和公開 JSON URL。
在重複使用主張時，請保留來源 URL、語言、快照雜湊值、證據摘要、信心度以及審查狀態。
信心度與審查狀態為獨立欄位。
原始語言證據為準。
請勿將機器候選或待審的主張呈現為最終政策結論。
貢獻端點僅提供後設資料。公開提交的內容會透過 GitHub issue 範本建立審查任務，而非直接成為正式的權威事實。

JavaScript 嵌入

嵌入腳本會呈現精簡的 Shadow DOM 卡片，且僅讀取小工具專用的公開 JSON。卡片會連回追蹤器的標準頁面，並避免顯示未經審查的主張內容。

Script/widgets/embed.js

跨網站使用

小工具 JSON 端點及公開實體搜尋端點包含寬鬆的 CORS 標頭，以供公開嵌入和基於瀏覽器的查詢。其他公開 API 端點維持一般的同源 JSON，除非另有說明。

CORSWidgets and search

建議上限: 60 requests per minute per client for public JSON usage
用戶端快取: 3600 最短秒數
大量使用: Use dataset release artifacts instead of repeatedly walking per-university endpoints.
爬蟲使用: Use the sitemap, llms.txt, dataset manifest, and public API index. Do not bypass robots, login walls, paywalls, or university source-site terms.

This is a public fair-use policy, not a paid API SLA. Limits may be enforced or adjusted as traffic grows.