API reference

Versioned read-only public data API

The public API is a citation and lookup surface for policy metadata, not an internal app API. Every public JSON endpoint is versioned under /api/public/v1/... and should be used with canonical page URLs, public JSON URLs, source URLs, review state, and citation fields.

Endpoint families

Read-only endpoints for records, releases, widgets, feeds, and agent integrations.

Discovery

Public API index with endpoint links, trust pages, citation rules, limitations, and version metadata.

Citation and evidence requirements

All API consumers should preserve the evidence model when displaying or summarizing public data.

  • Cite the canonical page URL and public JSON URL together.
  • Treat each claim as reusable only with its source URL, source language, source snapshot hash, evidence snippet, confidence, and review state.
  • Keep confidence separate from review state. Confidence is extraction confidence; review state is publication workflow status.
  • Original-language evidence is canonical. Localized display text is only a helper layer.
  • Do not present machine-candidate or needs-review claims as final policy conclusions.
  • Contribution endpoints are metadata only. Public submissions create review tasks through GitHub issue templates, not direct canonical facts.

Embeddable widget contract

Public widgets use the same API contract, with CORS enabled only on widget JSON endpoints.

JavaScript embed

The embed script renders a compact Shadow DOM card and reads only widget-specific public JSON. It links back to canonical tracker pages and avoids unreviewed claim text.

Script/widgets/embed.js

Cross-site use

Widget JSON endpoints include permissive CORS headers for public embedding. General public API endpoints remain normal same-origin JSON unless separately documented.

CORSWidget endpoints only

Rate-limit and crawler policy

This is a public fair-use policy, not a paid API SLA.

Suggested limit
60 requests per minute per client for public JSON usage
Client cache
3600 seconds minimum
Bulk use
Use dataset release artifacts instead of repeatedly walking per-university endpoints.
Crawler use
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.