University AI Policy Tracker
APIGitHub
한국어

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 대학의 정식 슬러그(식별자)를 찾기 위함. 별칭 일치는 재현율(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 색인입니다.

GET/api/public/v1/index.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/claims/{slug}.jsonRead-only

AI 도구 디렉터리

도구별 이용 가능 여부, 권장 유형, 검토 상태 및 근거 발췌를 포함한 대학 AI 도구의 파생 기록입니다. 도구 기록은 탐색용 메타데이터이며 공식 정책 결론이 아닙니다.

GET/api/public/v1/tools.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

검토 큐

검증 상태, 출처 범위, 감지된 URL 식별자 및 권장 다음 조치를 포함한 미공개 스테이징 실행 메타데이터입니다.

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

보고서 색인

기계 판독 가능 보고서 색인으로, 보고서 URL, 지표, 데이터 링크, 피드, 아웃리치 탐색 정보를 포함합니다.

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

보고서 홍보 자료 패키지

명시적 사용 범위가 있는 기계 판독형 미디어, 뉴스레터, 연구자 이메일 및 소셜 미디어 문안입니다.

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

MCP 알파 명세

허용된 도구 구조, 금지된 작업 및 에이전트 질의 예제를 포함한 읽기 전용 MCP 설계 명세입니다.

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

MCP 도구 목록

입력 스키마, 필수 출력 필드 및 엄격히 금지된 변경 작업을 포함한 읽기 전용 MCP 알파 도구 목록입니다.

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

인용 메타데이터

기계 판독형 인용 서식, 필수 필드, 근거 규칙, 출처 권리 유의사항 및 조언을 제공하지 않는다는 범위입니다.

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

인용 및 근거 요건

공개 데이터를 재사용할 때 근거 모델을 유지하세요.

  • 표준 페이지 URL과 공개 JSON URL을 함께 인용하십시오.
  • 주장 재사용 시 출처 URL, 언어, 스냅샷 해시, 증거 발췌문, 신뢰도 및 검토 상태를 유지하십시오.
  • 신뢰도와 검토 상태는 별도의 항목입니다.
  • 원어 증거가 표준입니다.
  • 기계 후보 또는 검토 필요 주장을 최종 정책 결론으로 제시해서는 안 됩니다.
  • 기여 엔드포인트는 메타데이터만 다룹니다. 공개 제출물은 GitHub 이슈 템플릿을 통해 검토 작업을 만들며, 직접적인 정본 사실이 되지는 않습니다.

삽입형 위젯 계약

공개 위젯은 동일한 API 계약을 사용하며, 삽입형 위젯 JSON과 개체 검색에 CORS가 활성화되어 있습니다.

JavaScript 임베드

임베드 스크립트는 간결한 Shadow DOM 카드를 렌더링하며, 위젯 전용 공개 JSON만 읽습니다. 표준 트래커 페이지로 다시 연결되며, 검토되지 않은 주장 텍스트는 피합니다.

Script/widgets/embed.js

사이트 간 사용

위젯 JSON 엔드포인트와 공개 엔터티 검색 엔드포인트에는 공개 임베딩 및 브라우저 기반 조회를 위한 관대한 CORS 헤더가 포함되어 있습니다. 기타 공개 API 엔드포인트는 별도로 문서화되지 않는 한 일반적인 동일 출처 JSON으로 유지됩니다.

CORSWidgets and search

요청 제한 및 크롤러 정책

공개 공정 사용 정책이며 유료 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.