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 正規の大学スラッグを見つけるためのもの。別名との一致は再現率を高めますが、事実を新たに生み出すものではありません。

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 決定論的に導出されたメタデータとしてのみ。空でない分析ディメンションについては、常に根拠となるクレームIDと情報源URLを引用してください。

Step4

エンドポイントの分類

レコード、リリース、ウィジェット、フィード、エージェント連携。

Discovery

エンドポイントへのリンク、信頼性に関するページ、引用規則、制約、バージョンメタデータを含む公開 API 索引。

エンティティ検索

正規名、別名、公式出典のタイトル、主張の要約、出典ドメイン、分析軸で公開大学レコードを検索します。

安全な検索索引

生の出典スナップショット、非公開ファイル、未公開のステージング証拠、権威性のない表計算行を除いた、Pagefind 対応の公開検索索引。

エンティティ同定索引

検索の再現率を高める大学の正規エンティティの別名。別名の一致によって、公開方針に関する事実が生成されることはありません。

大学の記録

主張、証拠の抜粋、出典 URL、確信度、審査状況、権利に関する注意事項を含む、引用可能な大学レコード。

大学に関する主張

公開大学レコードの主張・証拠行。出典 URL、出典言語、スナップショットのハッシュ、確信度、審査状況を含みます。

AIツールディレクトリ

ツールごとの利用可否、推奨の種別、審査状況、証拠の抜粋を含む大学の AI ツールの派生レコード。発見用のメタデータであり、公式方針の結論ではありません。

分析 API インデックス

決定論的な方針分析軸、エンドポイントのパス、制約、スキーマのバージョンメタデータ。

大学の分析プロファイル

分析軸、証拠となる主張の識別子、出典 URL、確信度、審査状況、方針の網羅度スコアを含む、出典に基づく分析プロファイル。

方針の網羅度スコア

公開分析プロファイルの網羅性スコア一覧。スコアは、出典に基づく公開情報の網羅の幅を測るものであり、ポリシーの質を測るものではありません。

分析ページの品質

公開分析ページのための、読み取り専用のページ品質ゲート、索引可能性の状態、分析レビューのワークフロー、および助言を行わない境界。

QS 2026 の対象範囲

QS 2026 の対象校に関する収集網羅度の行。公開、ステージングのみ、欠落、出典数、審査状況、次の対応の項目を含みます。

情報源の状態

公開採用済みの出典スナップショットとステージング実行の、出典・取得の健全性メタデータ。修復計画用であり、主張の公開には使用しません。

レビュー待ち行列

検証状況、出典の広がり、検出された URL 識別子、推奨される次の対応を含む、未公開ステージング実行のメタデータ。

データセットの公開

成果物、行数、バイトサイズ、SHA-256 チェックサム、引用、制約を含むリリースマニフェスト。

レポート索引

レポートURL、指標、データリンク、フィード、アウトリーチ検出を含む、機械可読なレポートのインデックス。

報告の広報パッケージ

利用範囲を明示した、メディア、ニュースレター、研究者向けメール、ソーシャルメディア用の機械可読な文章。

ウィジェット索引

スクリプト URL、対応ウィジェット、制約、HTML 例を含むウィジェット検出用データ。

MCP アルファ版マニフェスト

許可されるツール構造、禁止操作、エージェントクエリの例を含む読み取り専用の MCP 設計マニフェスト。

MCPツールカタログ

入力スキーマ、必須出力項目、厳格に禁止される変更操作を含む読み取り専用の MCP アルファ版ツールカタログ。

引用メタデータ

機械可読な引用テンプレート、必須項目、証拠規則、出典の権利に関する注意事項、助言を提供しないという境界。

引用と証拠の要件

公開データを再利用する際は証拠モデルを維持してください。

  • 基準となるページURLと公開JSON URLを併せて引用してください。
  • クレームの再利用時には、情報源URL、言語、スナップショットハッシュ、根拠スニペット、信頼度、およびレビュー状態を保持してください。
  • 信頼度(confidence)とレビュー状態は、別個のフィールドです。
  • 原文言語による証拠が正本です。
  • 機械による候補や要確認の主張を、最終的な方針上の結論として提示しないでください。
  • 投稿エンドポイントはメタデータのみです。公開された投稿は、GitHubのissueテンプレートを通じてレビュータスクを作成するものであり、直接の正規の事実ではありません。

埋め込みウィジェットの契約

公開ウィジェットは同じ 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.