Referencia de la API

API pública de datos de solo lectura con versiones

Endpoints de citación y búsqueda para metadatos de políticas públicas. Cada endpoint JSON está versionado bajo /api/public/v1.

Qué devuelve la API

Metadatos del rastreador de solo lectura: URL canónicas de registros, JSON público, estados de revisión, campos de evidencia, enlaces de fuentes y campos de citación.

Lo que la API no hace

No modifica registros, no publica ejecuciones de preproducción, no evita el estado de revisión ni sustituye las fuentes oficiales de políticas de la universidad.

Recuperación recomendada

Resuelva mediante búsqueda o alias de entidades, obtenga el registro universitario y luego adjunte las pruebas de las afirmaciones y las URL de las fuentes para respuestas a nivel de afirmación.

Posicionamiento de agentes y API

Uso recomendado para agentes y herramientas de datos.

  • Uso para resúmenes basados en fuentes, JSON público, metadatos de citación, estado de revisión y enlaces a fuentes oficiales.
  • Utilice las páginas oficiales de la universidad como fuente de autoridad para el lenguaje de las políticas.
  • No considere el análisis como asesoramiento, guía de seguridad o cumplimiento normativo.
  • Las coincidencias de alias, los temas y las puntuaciones de cobertura no crean hechos.
  • Los registros de herramientas se derivan del texto de las afirmaciones y de la evidencia; no sustituyen el lenguaje original de las fuentes universitarias oficiales.

Secuencia de recuperación recomendada

Orden seguro de recuperación para agentes que necesitan respuestas respaldadas por citas.

Resolver la entidad

Llamada /api/public/v1/search.json?q=... o inspeccionar /api/public/v1/entities/index.json Para encontrar el slug canónico de la universidad. Las coincidencias de alias mejoran la recuperación, pero no crean hechos.

Step1

Abrir el registro canónico

Obtener /api/public/v1/universities/{slug}.json y mantenga la URL canónica de la página, la URL pública del JSON, el estado de revisión, la fecha de última comprobación, las limitaciones y los campos de citación con la respuesta.

Step2

Adjuntar evidencia de la afirmación

Obtener /api/public/v1/claims/{slug}.json cuando sea necesaria la reutilización a nivel de afirmación. Conserve las URL de origen, el idioma de origen, los fragmentos de evidencia, los hashes de las instantáneas, la confianza y el estado de revisión.

Step3

Utilice el análisis como metadatos derivados

Obtener /api/public/v1/analysis/universities/{slug}.json solo como metadatos derivados deterministas. Cite siempre los ID de afirmación de base y las URL de las fuentes para las dimensiones de análisis que no estén vacías.

Step4

Familias de puntos de acceso

Registros, publicaciones, widgets, fuentes e integraciones de agentes.

Discovery

Índice de la API pública con enlaces a puntos de acceso, páginas de confianza, normas de citación, limitaciones y metadatos de versión.

Universidades

Lista de registros universitarios públicos con URL canónica de la página, URL del JSON público, estado de revisión, fechas y recuentos.

Búsqueda de entidades

Busca registros universitarios públicos por nombre canónico, alias, título de fuente oficial, resumen de afirmación, dominio de origen o dimensión de análisis.

Índice de búsqueda seguro

Índice de búsqueda público preparado para Pagefind que excluye instantáneas de fuentes sin procesar, archivos privados, evidencias en preparación no publicadas y filas de hojas de cálculo sin autoridad.

Índice de resolución de entidades

Alias de entidades universitarias canónicas para mejorar la recuperación. Las coincidencias de alias no crean hechos públicos sobre políticas.

Registro universitario

Un registro universitario listo para citar con afirmaciones, fragmentos de evidencia, URL de fuentes, confianza, estado de revisión y advertencias sobre derechos.

Afirmaciones universitarias

Filas de afirmaciones y evidencias de un registro universitario público con URL de fuente, idioma de origen, hash de la instantánea, confianza y estado de revisión.

Directorio de herramientas de IA

Registros derivados de herramientas universitarias de IA con disponibilidad por herramienta, tipo de respaldo, estado de revisión y fragmentos de evidencia. Son metadatos de descubrimiento, no conclusiones de políticas oficiales.

Índice de la API de análisis

Dimensiones deterministas de análisis de políticas, rutas de puntos de acceso, limitaciones y metadatos de versión del esquema.

Perfil de análisis de la universidad

Perfil de análisis respaldado por fuentes con dimensiones, identificadores de afirmaciones de evidencia, URL de fuentes, confianza, estado de revisión y puntuación de cobertura de políticas.

Puntuaciones de cobertura de políticas

Lista de puntuaciones de cobertura para los perfiles de análisis públicos. Las puntuaciones miden la amplitud de la cobertura pública respaldada por fuentes, no la calidad de la política.

Calidad de la página de análisis

Controles de calidad de página de solo lectura, estado de indexabilidad, flujo de revisión de análisis y límites de no asesoramiento para las páginas de análisis públicas.

Cobertura QS 2026

Filas de cobertura de recopilación para los objetivos QS 2026 con campos de público, solo en preparación, ausente, número de fuentes, estado de revisión y próxima acción.

Estado de las fuentes

Metadatos del estado de fuentes y descargas para instantáneas de fuentes publicadas y ejecuciones en preparación. Se usan para planificar reparaciones, no para publicar afirmaciones.

Cola de revisión

Metadatos de ejecuciones en preparación no publicadas con estado de validación, amplitud de fuentes, identificadores de URL detectados y próxima acción recomendada.

Publicación del conjunto de datos

Manifiesto de publicación con artefactos, recuentos de filas, tamaños en bytes, sumas de comprobación SHA-256, citación y limitaciones.

Índice de informes

Índice de informes legibles por máquina con URL de los informes, métricas, enlaces a datos, canales de sindicación (feeds) y descubrimiento de actividades de divulgación.

Paquete de difusión de informes

Textos legibles por máquina para medios, boletines, correos a investigadores y redes sociales, con límites de uso explícitos.

Manifiesto alfa de MCP

Manifiesto de diseño de MCP de solo lectura con estructuras de herramientas permitidas, acciones prohibidas y consultas de agentes de ejemplo.

Catálogo de herramientas MCP

Catálogo alfa de herramientas MCP de solo lectura con esquemas de entrada, campos de salida obligatorios y modificaciones estrictamente prohibidas.

Metadatos de citación

Plantillas de citación legibles por máquina, campos obligatorios, normas de evidencia, advertencia sobre derechos de fuentes y límite de no asesoramiento.

Índice de contribución

Metadatos de solo lectura del flujo de contribución, URL de plantillas de incidencias de GitHub, salvaguardas y normas de publicación.

Requisitos de citación y evidencia

Conserva el modelo de evidencia al reutilizar los datos públicos.

  • Cite conjuntamente la URL de la página canónica y la URL del JSON público.
  • Conserve la URL de origen, el idioma, el hash de la instantánea, el fragmento de evidencia, la confianza y el estado de revisión con la reutilización de la afirmación.
  • El nivel de confianza y el estado de revisión son campos independientes.
  • La evidencia en el idioma original es canónica.
  • No presente como conclusiones definitivas de la política las afirmaciones candidatas generadas automáticamente o pendientes de revisión.
  • Los puntos de acceso de contribución solo contienen metadatos. Las contribuciones públicas crean tareas de revisión mediante plantillas de incidencias de GitHub, no hechos canónicos directos.

Contrato de widgets integrables

Los widgets públicos usan el mismo contrato de API, con CORS habilitado para el JSON de widgets integrables y la búsqueda de entidades.

Inserción de JavaScript

El script de inserción muestra una tarjeta compacta en Shadow DOM y lee solo el JSON público específico del widget. Enlaza a las páginas canónicas del rastreador y evita el texto de afirmaciones sin revisar.

Script/widgets/embed.js

Uso entre sitios

Los puntos finales JSON de widgets y el punto final público de búsqueda de entidades incluyen encabezados CORS permisivos para inserción pública y búsqueda basada en navegador. Otros puntos finales públicos de la API permanecen como JSON normal de mismo origen a menos que se documente por separado.

CORSWidgets and search

Política de límites de solicitudes y rastreadores

Esta es una política pública de uso justo, no un acuerdo de nivel de servicio de una API de pago.

Límite sugerido
60 requests per minute per client for public JSON usage
Caché del cliente
3600 segundos como mínimo
Uso masivo
Use dataset release artifacts instead of repeatedly walking per-university endpoints.
Uso de rastreadores
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.