Довідник API

Версійний публічний API даних лише для читання

Кінцеві точки для цитування та пошуку метаданих публічної політики. Кожна кінцева точка JSON має версію в межах /api/public/v1.

Що повертає API

Метадані трекера лише для читання: канонічні URL-адреси записів, публічний JSON, стани перевірки, поля доказів, посилання на джерела та поля цитування.

Чого API не робить

Він не змінює записи, не публікує проміжні запуски, не обходить стан перевірки та не замінює офіційні джерела політик університету.

Рекомендоване отримання

Знайдіть через пошук або псевдоніми сутностей, отримайте запис університету, а потім додайте докази твердження та URL-адреси джерел для відповідей на рівні твердження.

Позиціонування агентів і API

Рекомендоване використання для агентів та інструментів даних.

  • Використовуйте для підсумків, підкріплених джерелами, публічних JSON, метаданих цитувань, стану перевірки та посилань на офіційні джерела.
  • Як авторитетне джерело формулювань політики використовуйте офіційні сторінки університету.
  • Не сприймайте аналіз як консультацію, рекомендації з безпеки чи відповідність вимогам.
  • Збіги псевдонімів, теми та оцінки охоплення не створюють фактів.
  • Записи інструментів формуються на основі тексту тверджень і доказів; вони не замінюють формулювання офіційних університетських першоджерел.

Рекомендована послідовність пошуку

Безпечний порядок пошуку для агентів, яким потрібні відповіді з посиланнями на джерела.

Визначити сутність

Виклик /api/public/v1/search.json?q=... або оглянути /api/public/v1/entities/index.json щоб знайти канонічний ідентифікатор (slug) університету. Збіги за псевдонімами покращують повноту (recall), але не створюють фактів.

Step1

Відкрити канонічний запис

Отримати /api/public/v1/universities/{slug}.json і збережіть із відповіддю канонічний URL сторінки, публічний JSON URL, стан перевірки, дату останньої перевірки, обмеження та поля цитування.

Step2

Долучити свідчення твердження

Отримати /api/public/v1/claims/{slug}.json коли потрібне повторне використання на рівні тверджень. Зберігайте URL джерел, мову джерела, фрагменти доказів, хеші знімків, рівень впевненості та стан перевірки.

Step3

Використовувати аналіз як отримані метадані

Отримати /api/public/v1/analysis/universities/{slug}.json тільки як детерміновані похідні метадані. Завжди цитуйте базові ідентифікатори тверджень (Claim ID) та URL-адреси джерел для непорожніх аналітичних вимірів.

Step4

Групи кінцевих точок

Записи, випуски, віджети, канали й інтеграції агентів.

Discovery

Індекс публічного API з посиланнями на кінцеві точки, сторінками довіри, правилами цитування, обмеженнями й метаданими версій.

Університети

Перелік публічних записів університетів із канонічним URL сторінки, URL публічного JSON, станом перевірки, датами й кількостями.

Пошук сутностей

Пошук публічних записів університетів за канонічною назвою, псевдонімом, заголовком офіційного джерела, стислим викладом твердження, доменом джерела чи виміром аналізу.

Безпечний пошуковий індекс

Публічний пошуковий індекс для Pagefind без сирих знімків джерел, приватних файлів, неопублікованих підготовчих доказів і рядків таблиць, що не є авторитетними джерелами.

Індекс зіставлення сутностей

Псевдоніми канонічних сутностей університетів для повнішого пошуку. Збіг псевдоніма не створює публічних фактів про політику.

Запис університету

Один готовий до цитування запис університету з твердженнями, уривками доказів, URL джерел, рівнем упевненості, станом перевірки й застереженнями щодо прав.

Твердження про університети

Рядки тверджень/доказів одного публічного запису університету з URL джерела, мовою джерела, хешем знімка, рівнем упевненості й станом перевірки.

Каталог інструментів ШІ

Похідні записи інструментів ШІ університетів із доступністю кожного інструмента, типом схвалення, станом перевірки й уривками доказів. Це метадані для пошуку, а не офіційні висновки щодо політики.

Останні зміни

Нещодавні перевірки публічних джерел і змінені записи закладів.

Індекс API аналізу

Детерміновані виміри аналізу політик, шляхи кінцевих точок, обмеження й метадані версії схеми.

Профіль університетського аналізу

Профіль аналізу на основі джерел із вимірами, ID доказових тверджень, URL джерел, рівнем упевненості, станом перевірки й оцінкою охоплення політик.

Оцінки охоплення політик

Список оцінок охоплення для публічних аналітичних профілів. Оцінки вимірюють широту підтвердженого джерелами публічного охоплення, а не якість політики.

Якість сторінки аналізу

Контроль якості сторінок у режимі лише для читання, статус індексованості, процес перевірки аналізу та межі, за яких не надаються поради, для загальнодоступних сторінок аналізу.

Покриття QS 2026

Рядки охоплення збору для цілей QS 2026 із полями публічних, лише підготовчих, відсутніх записів, кількості джерел, стану перевірки й наступної дії.

Стан джерел

Метадані справності джерел/завантаження для опублікованих знімків публічних джерел і підготовчих запусків. Для планування виправлень, а не публікації тверджень.

Черга перевірки

Метадані неопублікованих підготовчих запусків зі станом валідації, широтою джерел, виявленими слагами й рекомендованою наступною дією.

Випуск набору даних

Маніфест випуску з артефактами, кількістю рядків, розмірами в байтах, контрольними сумами SHA-256, цитуванням і обмеженнями.

Індекс звітів

Індекс машиночитаних звітів із URL звітів, метриками, посиланнями на дані, стрічками та виявленням каналів для комунікацій.

Дані діаграми звіту

Готові до діаграм розподіли мов джерел, станів перевірки, охоплення регіонів, міст/кампусів і рейтингів для останнього місячного звіту.

Пакет поширення звітів

Машиночитані тексти для медіа, розсилок, листів дослідникам і соцмереж із чіткими межами використання.

Індекс віджетів

Дані виявлення віджетів з URL скрипту, підтримуваними віджетами, обмеженнями й прикладом HTML.

Віджет стану університету

Стислі дані віджета з актуальністю, станом перевірки, кількістю тверджень/джерел і канонічними посиланнями.

Віджет останніх змін

Стислі дані останніх змін для віджетів перевірки публічних джерел і змін.

Віджет охоплення політики

Стислі дані віджета охоплення політик на основі джерел. Охоплення означає широту, а не якість політики.

Віджет актуальності джерел

Стислі дані віджета актуальності джерел із датою останньої перевірки, кількістю джерел і показниками справності публічних джерел.

Віджет стану перевірки

Стислі дані віджета стану перевірки з рівнем упевненості, перевіреними твердженнями й кількістю кандидатних тверджень.

Маніфест MCP альфа

Маніфест дизайну MCP лише для читання з дозволеними формами інструментів, забороненими діями й прикладами запитів агентів.

Каталог інструментів MCP

Каталог інструментів MCP альфа лише для читання зі схемами вводу, обов’язковими полями виводу й категорично забороненими змінами.

Політика обмеження частоти

Машиночитана публічна політика добросовісного використання для доступу API, віджетів і сканерів.

Метадані цитування

Машиночитані шаблони цитування, обов’язкові поля, правила доказів, застереження щодо прав на джерела й межа ненадання порад.

Індекс внеску

Метадані процесу внесків лише для читання, URL шаблонів звернень GitHub, запобіжні заходи й правила публікації.

Політика перевірки внесків

Визначення черг перевірки, межі модерації й шлюзи публікації лише для читання.

Вимоги до цитування й доказів

Зберігайте модель доказів під час повторного використання публічних даних.

  • Цитуйте канонічну URL-адресу сторінки разом із публічною URL-адресою JSON.
  • Зберігайте URL-адресу джерела, мову, хеш снепшота, фрагмент доказу, рівень достовірності та стан перевірки при повторному використанні твердження.
  • Рівень довіри та стан перегляду — окремі поля.
  • Свідчення мовою оригіналу є канонічними.
  • Не подавайте кандидатні твердження, відібрані машиною, або твердження, що потребують перегляду, як остаточні висновки політики.
  • Кінцеві точки внесків містять лише метадані. Публічні подання створюють завдання для перевірки через шаблони issue у GitHub, а не безпосередньо канонічні факти.

Контракт вбудовуваних віджетів

Публічні віджети використовують той самий контракт API; CORS увімкнено для JSON вбудовуваних віджетів і пошуку сутностей.

Вбудовування JavaScript

Скрипт вбудовування відображає компактну картку Shadow DOM і читає лише публічний JSON, специфічний для віджета. Він посилається на канонічні сторінки трекера та не використовує текст тверджень, які не переглянуто.

Script/widgets/embed.js

Використання між сайтами

Кінцеві точки JSON віджета та публічна кінцева точка пошуку сутностей містять дозволені заголовки CORS для публічного вбудовування та пошуку в браузері. Інші публічні кінцеві точки API залишаються звичайними JSON одного джерела походження, якщо окремо не зазначено інше.

CORSWidgets and search

Політика обмеження частоти й сканерів

Це публічна політика добросовісного використання, а не SLA платного API.

Рекомендований ліміт
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.