Referensi API

API data publik berversi dan hanya-baca

Endpoint sitasi dan pencarian untuk metadata kebijakan publik. Setiap endpoint JSON diberi versi di bawah /api/public/v1.

Apa yang dikembalikan oleh API

Metadata pelacak hanya-baca: URL catatan kanonikal, JSON publik, status peninjauan, bidang bukti, tautan sumber, dan bidang sitasi.

Apa yang tidak dilakukan API

Ini tidak mengubah catatan, tidak menerbitkan run staging, tidak melewati status tinjauan, dan tidak menggantikan sumber kebijakan resmi universitas.

Pengambilan yang direkomendasikan

Selesaikan dengan pencarian atau alias entitas, ambil rekaman universitas, lalu lampirkan bukti klaim dan URL sumber untuk jawaban tingkat klaim.

Penempatan agen dan API

Penggunaan yang disarankan untuk agen dan alat data.

  • Digunakan untuk ringkasan berbasis sumber, JSON publik, metadata sitasi, status tinjauan, dan tautan sumber resmi.
  • Gunakan halaman resmi universitas sebagai otoritas untuk bahasa kebijakan.
  • Jangan perlakukan analisis sebagai nasihat, panduan keselamatan, atau kepatuhan.
  • Kecocokan alias, tema, dan skor cakupan tidak menciptakan fakta.
  • Catatan alat diturunkan dari teks klaim dan bukti; catatan tersebut tidak menggantikan bahasa sumber resmi universitas.

Urutan pengambilan yang direkomendasikan

Urutan pengambilan informasi yang aman bagi agen yang memerlukan jawaban berbasis sitasi.

Selesaikan entitas

Panggilan /api/public/v1/search.json?q=... atau periksa /api/public/v1/entities/index.json untuk menemukan slug universitas kanonis. Kecocokan alias meningkatkan cakupan pencarian (recall), tetapi tidak menciptakan fakta.

Step1

Buka catatan kanonis

Ambil /api/public/v1/universities/{slug}.json dan pertahankan URL halaman kanonis, URL JSON publik, status penelaahan, tanggal terakhir diperiksa, batasan, dan bidang sitasi bersama jawaban.

Step2

Lampirkan bukti klaim

Ambil /api/public/v1/claims/{slug}.json saat penggunaan ulang di tingkat klaim diperlukan. Pertahankan URL sumber, bahasa sumber, cuplikan bukti, hash snapshot, tingkat keyakinan, dan status tinjauan.

Step3

Gunakan analisis sebagai metadata turunan

Ambil /api/public/v1/analysis/universities/{slug}.json hanya sebagai metadata turunan deterministik. Selalu kutip ID klaim dasar dan URL sumber untuk dimensi analisis yang tidak kosong.

Step4

Kelompok titik akhir

Catatan, rilis, widget, umpan, dan integrasi agen.

Discovery

Indeks API publik dengan tautan titik akhir, halaman kepercayaan, aturan sitasi, batasan, dan metadata versi.

Universitas

Daftar catatan perguruan tinggi publik dengan URL halaman kanonis, URL JSON publik, status peninjauan, tanggal, dan jumlah.

Pencarian entitas

Cari catatan perguruan tinggi publik berdasarkan nama kanonis, alias, judul sumber resmi, ringkasan klaim, domain sumber, atau dimensi analisis.

Indeks pencarian aman

Indeks pencarian publik siap Pagefind yang mengecualikan cuplikan mentah sumber, berkas privat, bukti tahap persiapan yang belum dipublikasikan, dan baris lembar kerja yang tidak otoritatif.

Indeks resolusi entitas

Alias entitas perguruan tinggi kanonis untuk meningkatkan keterjangkauan pencarian. Kecocokan alias tidak menciptakan fakta kebijakan publik.

Catatan universitas

Satu catatan perguruan tinggi siap sitasi dengan klaim, kutipan bukti, URL sumber, tingkat keyakinan, status peninjauan, dan peringatan hak penggunaan.

Klaim perguruan tinggi

Baris klaim dan bukti dari satu catatan perguruan tinggi publik dengan URL sumber, bahasa sumber, hash cuplikan, tingkat keyakinan, dan status peninjauan.

Direktori alat AI

Catatan turunan alat AI perguruan tinggi dengan ketersediaan per alat, jenis dukungan institusi, status peninjauan, dan kutipan bukti. Catatan alat adalah metadata penemuan, bukan kesimpulan kebijakan resmi.

Cakupan QS 2026

Baris cakupan pengumpulan untuk target QS 2026 dengan kolom publik, hanya dalam persiapan, belum tersedia, jumlah sumber, status peninjauan, dan tindakan berikutnya.

Kesehatan sumber

Metadata kondisi sumber dan pengambilan untuk cuplikan sumber publik yang telah dipublikasikan dan proses tahap persiapan. Digunakan untuk perencanaan perbaikan, bukan publikasi klaim.

Antrean peninjauan

Metadata proses tahap persiapan yang belum dipublikasikan dengan status validasi, keluasan sumber, slug yang terdeteksi, dan tindakan berikutnya yang disarankan.

Metadata sitasi

Templat sitasi yang dapat dibaca mesin, kolom wajib, aturan bukti, peringatan hak sumber, dan batasan bahwa informasi bukan nasihat.

Persyaratan sitasi dan bukti

Pertahankan model bukti saat menggunakan kembali data publik.

  • Sitasi URL halaman kanonik dan URL JSON publik secara bersamaan.
  • Pertahankan URL sumber, bahasa, hash cuplikan, cuplikan bukti, tingkat keyakinan, dan status peninjauan saat menggunakan kembali klaim.
  • Tingkat keyakinan dan status tinjauan adalah bidang yang terpisah.
  • Bukti bahasa asli bersifat kanonikal.
  • Jangan menyajikan klaim kandidat mesin atau klaim yang perlu ditinjau sebagai kesimpulan kebijakan final.
  • Endpoint kontribusi hanya berisi metadata. Pengajuan publik membuat tugas tinjauan melalui templat isu GitHub, bukan fakta kanonis langsung.

Kontrak widget sematan

Widget publik menggunakan kontrak API yang sama, dengan CORS diaktifkan untuk JSON widget sematan dan pencarian entitas.

Sematkan JavaScript

Skrip embed menampilkan kartu Shadow DOM yang ringkas dan hanya membaca JSON publik khusus widget. Kartu ini menautkan kembali ke halaman pelacak kanonis dan tidak menampilkan teks klaim yang belum ditinjau.

Script/widgets/embed.js

Penggunaan lintas situs

Endpoint JSON widget dan endpoint pencarian entitas publik menyertakan header CORS yang permisif untuk penyematan publik dan pencarian berbasis peramban. Endpoint API publik lainnya tetap berupa JSON same-origin biasa kecuali didokumentasikan secara terpisah.

CORSWidgets and search

Kebijakan batas permintaan dan perayap

Ini adalah kebijakan penggunaan wajar publik, bukan SLA API berbayar.

Batas yang disarankan
60 requests per minute per client for public JSON usage
Cache klien
3600 minimal detik
Penggunaan massal
Use dataset release artifacts instead of repeatedly walking per-university endpoints.
Penggunaan crawler
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.