API-referentie

Geversioneerde, alleen-lezen openbare data-API

Eindpunten voor citaten en opzoeken van metadata van openbaar beleid. Elk JSON-eindpunt is geversioneerd onder /api/public/v1.

Wat de API retourneert

Alleen-lezen trackermetagegevens: canonieke record-URL's, openbare JSON, revisiestatussen, bewijsvelden, bronlinks en citatievelden.

Wat de API niet doet

Het wijzigt geen records, publiceert geen stagingruns, omzeilt de beoordelingsstatus niet en vervangt geen officiële beleidsbronnen van de universiteit.

Aanbevolen ophaling

Los op met zoekopdrachten of entiteitsaliassen, haal het universitaire dossier op en voeg vervolgens claimbewijs en bron-URL's toe voor antwoorden op claimniveau.

Positionering van agenten en API

Aanbevolen gebruik voor agenten en datatools.

  • Gebruik voor op bronnen gebaseerde samenvattingen, openbare JSON, citatiemetadata, beoordelingsstatus en officiële bronlinks.
  • Gebruik officiële universiteitspagina’s als gezaghebbende bron voor beleidsteksten.
  • Beschouw de analyse niet als advies, veiligheidsrichtlijn of naleving.
  • Aliasovereenkomsten, thema's en dekkingsscores creëren geen feiten.
  • Toolrecords zijn afgeleid van de tekst van claims en bewijsmateriaal; ze vervangen niet de officiële bewoordingen van de universitaire bron.

Aanbevolen zoekvolgorde

Een veilige ophaalvolgorde voor agenten die antwoorden met bronverwijzingen nodig hebben.

Entiteit oplossen

Bellen /api/public/v1/search.json?q=... of inspecteren /api/public/v1/entities/index.json om de canonieke slug van de universiteit te vinden. Aliasovereenkomsten verbeteren de terugvindbaarheid, maar creëren geen feiten.

Step1

Open het canonieke record

Ophalen /api/public/v1/universities/{slug}.json en behoud de canonieke pagina-URL, openbare JSON-URL, beoordelingsstatus, datum van laatste controle, beperkingen en citatievelden bij het antwoord.

Step2

Bewijsmateriaal voor claim bijvoegen

Ophalen /api/public/v1/claims/{slug}.json wanneer hergebruik op claimniveau nodig is. Bewaar bron-URL's, brontaal, bewijsfragmenten, snapshot-hashes, betrouwbaarheid en beoordelingsstatus.

Step3

Gebruik analyse als afgeleide metadata

Ophalen /api/public/v1/analysis/universities/{slug}.json alleen als deterministische afgeleide metagegevens. Citeer altijd de basis-claim-ID's en bron-URL's voor niet-lege analysedimensies.

Step4

Eindpuntgroepen

Records, releases, widgets, feeds en agentintegraties.

Discovery

Openbare API-index met eindpuntlinks, vertrouwenspagina’s, citatieregels, beperkingen en versiemetadata.

Universiteiten

Lijst met openbare universiteitsrecords met canonieke pagina-URL, openbare JSON-URL, beoordelingsstatus, datums en aantallen.

Entiteiten zoeken

Zoek openbare universiteitsrecords op canonieke naam, alias, titel van de officiële bron, samenvatting van een bewering, brondomein of analysedimensie.

Veilige zoekindex

Openbare zoekindex voor Pagefind zonder ruwe bronmomentopnamen, privébestanden, nog niet gepubliceerde voorbereidende bewijzen en niet-gezaghebbende spreadsheetrijen.

Index voor entiteitsherkenning

Aliassen van canonieke universiteitsentiteiten om meer relevante resultaten te vinden. Een aliasovereenkomst creëert geen openbare beleidsfeiten.

Universitair dossier

Eén citeerbaar universiteitsrecord met beweringen, bewijsfragmenten, bron-URL’s, betrouwbaarheid, beoordelingsstatus en voorbehouden over rechten.

Universiteitsbeweringen

Bewering- en bewijsrijen van één openbaar universiteitsrecord met bron-URL, brontaal, hash van de momentopname, betrouwbaarheid en beoordelingsstatus.

Directory van AI-tools

Afgeleide records over universitaire AI-tools met beschikbaarheid per tool, type aanbeveling, beoordelingsstatus en bewijsfragmenten. Toolrecords zijn ontdekkingsmetadata, geen officiële beleidsconclusies.

Kwaliteit van de analysepagina

Alleen-lezen kwaliteitspoorten voor pagina's, indexeerbaarheidsstatus, werkstroom voor analysebeoordeling en grenzen voor het niet geven van advies op openbare analysepagina's.

Dekking QS 2026

Verzamelingsdekkingsrijen voor QS 2026-doelen met velden voor openbaar, alleen in voorbereiding, ontbrekend, bronaantal, beoordelingsstatus en volgende actie.

Bronstatus

Metadata over bron- en ophaalstatus voor gepubliceerde bronmomentopnamen en voorbereidende uitvoeringen. Bedoeld voor herstelplanning, niet voor publicatie van beweringen.

Beoordelingswachtrij

Metadata van nog niet gepubliceerde voorbereidende uitvoeringen met validatiestatus, bronbreedte, gedetecteerde URL-identificatoren en aanbevolen volgende actie.

Verspreidingspakket voor rapporten

Machineleesbare teksten voor media, nieuwsbrieven, e-mails aan onderzoekers en sociale media, met expliciete gebruiksgrenzen.

Citatiemetadata

Machineleesbare citatiesjablonen, verplichte velden, bewijsregels, voorbehoud over bronrechten en grens dat geen advies wordt verstrekt.

Citatie- en bewijsvereisten

Behoud het bewijsmodel bij hergebruik van openbare gegevens.

  • Citeer de canonieke pagina-URL en openbare JSON-URL samen.
  • Behoud bron-URL, taal, snapshothash, bewijsfragment, betrouwbaarheid en beoordelingsstatus bij hergebruik van claims.
  • Vertrouwensniveau en beoordelingsstatus zijn afzonderlijke velden.
  • Bewijsmateriaal in de oorspronkelijke taal is bindend.
  • Presenteer machinale kandidaatclaims of claims die beoordeling nodig hebben niet als definitieve beleidsconclusies.
  • Bijdrage-endpoints bevatten alleen metadata. Openbare inzendingen maken beoordelingstaken aan via GitHub-issuesjablonen, niet via directe canonieke feiten.

Contract voor insluitbare widgets

Openbare widgets gebruiken hetzelfde API-contract, met CORS voor JSON van insluitbare widgets en het zoeken naar entiteiten.

JavaScript-insluiting

Het embed-script toont een compacte Shadow DOM-kaart en leest alleen widgetspecifieke openbare JSON. Het verwijst terug naar de canonieke pagina's van de tracker en vermijdt niet-beoordeelde claimtekst.

Script/widgets/embed.js

Cross-site gebruik

Widget-JSON-eindpunten en het openbare zoek-eindpunt voor entiteiten bevatten permissieve CORS-headers voor openbare insluiting en browsergebaseerde zoekacties. Andere openbare API-eindpunten blijven normale same-origin-JSON tenzij afzonderlijk gedocumenteerd.

CORSWidgets and search

Beleid voor aanvraaglimieten en crawlers

Dit is een openbaar beleid voor redelijk gebruik, geen serviceniveauovereenkomst voor een betaalde API.

Voorgestelde limiet
60 requests per minute per client for public JSON usage
Clientcache
3600 minimaal aantal seconden
Bulkgebruik
Use dataset release artifacts instead of repeatedly walking per-university endpoints.
Gebruik van crawlers
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.