Referência da API

API pública de dados somente leitura, com versionamento.

Pontos de acesso de citação e consulta para metadados de políticas públicas. Todos os endpoints JSON são versionados sob /api/public/v1.

O que a API devolve

Metadados do rastreador apenas de leitura: URLs de registos canónicos, JSON público, estados de revisão, campos de evidência, ligações de fontes e campos de citação.

O que a API não faz

Ele não altera registros, não publica execuções de homologação, não contorna o estado de revisão nem substitui as fontes oficiais de políticas da universidade.

Recuperação recomendada

Resolva com pesquisa ou identificadores alternativos da entidade, obtenha o registo da universidade e, em seguida, anexe a evidência da alegação e os URLs das fontes para respostas ao nível da alegação.

Posicionamento de agentes e API

Uso recomendado para agentes e ferramentas de dados.

  • Utilizar para resumos baseados em fontes, JSON público, metadados de citação, estado de revisão e ligações para fontes oficiais.
  • Utilize as páginas oficiais da universidade como fonte de autoridade para a linguagem da política.
  • Não considere a análise como conselho, orientação de segurança ou conformidade.
  • Correspondências de alias, temas e pontuações de cobertura não comprovam nada por si só.
  • Os registros de ferramentas são derivados do texto de alegações e evidências; eles não substituem a redação oficial das fontes universitárias.

Sequência de recuperação recomendada

Uma ordem segura de recuperação para agentes que precisam de respostas fundamentadas em citações.

Resolver a entidade

Chamada /api/public/v1/search.json?q=... ou inspecionar /api/public/v1/entities/index.json para encontrar o identificador de referência da universidade. As correspondências de alias melhoram a cobertura, mas não criam factos.

Step1

Abrir o registo canónico

Obter /api/public/v1/universities/{slug}.json e mantenha o URL canônico da página, o URL público do JSON, o estado de revisão, a data da última verificação, as limitações e os campos de citação junto com a resposta.

Step2

Anexar evidência da alegação

Obter /api/public/v1/claims/{slug}.json quando for necessária a reutilização ao nível da afirmação. Preserve os URL de origem, a língua de origem, os excertos de evidência, os hashes dos instantâneos, o nível de confiança e o estado de revisão.

Step3

Utilizar a análise como metadados derivados

Obter /api/public/v1/analysis/universities/{slug}.json apenas como metadados derivados determinísticos. Cite sempre os IDs das alegações de base e os URLs das fontes para dimensões de análise não vazias.

Step4

Famílias de endpoints

Registros, versões, widgets, feeds e integrações de agentes.

Discovery

Índice da API pública com links de endpoints, páginas de confiança, regras de citação, limitações e metadados de versão.

Universidades

Lista de registros universitários públicos com URL canônica da página, URL do JSON público, estado de revisão, datas e contagens.

Pesquisa de entidades

Pesquise registros universitários públicos por nome canônico, alias, título da fonte oficial, resumo de afirmação, domínio da fonte ou dimensão de análise.

Índice de pesquisa seguro

Índice de pesquisa público pronto para Pagefind, excluindo instantâneos de fontes brutas, arquivos privados, evidências em preparação ainda não publicadas e linhas de planilhas sem autoridade.

Índice de resolução de entidades

Aliases de entidades universitárias canônicas para ampliar a recuperação. Correspondências de aliases não criam fatos públicos sobre políticas.

Registo universitário

Um registro universitário pronto para citação com afirmações, trechos de evidência, URLs de fontes, confiança, estado de revisão e ressalvas sobre direitos.

Afirmações universitárias

Linhas de afirmações e evidências de um registro universitário público, com URL da fonte, idioma da fonte, hash do instantâneo, confiança e estado de revisão.

Diretório de ferramentas de IA

Registros derivados de ferramentas universitárias de IA com disponibilidade por ferramenta, tipo de endosso, estado de revisão e trechos de evidência. São metadados de descoberta, não conclusões de políticas oficiais.

Índice da API de análise

Dimensões determinísticas de análise de políticas, caminhos de endpoints, limitações e metadados da versão do esquema.

Perfil de análise da universidade

Perfil de análise fundamentado em fontes com dimensões, identificadores de afirmações de evidência, URLs de fontes, confiança, estado de revisão e pontuação de cobertura de políticas.

Pontuações de cobertura de políticas

Lista de pontuações de cobertura para perfis de análise pública. As pontuações medem a amplitude da cobertura pública respaldada por fontes, não a qualidade da política.

Qualidade da página de análise

Verificações de qualidade das páginas apenas de leitura, estado de indexabilidade, fluxo de revisão das análises e limites de não aconselhamento para as páginas públicas de análise.

Cobertura QS 2026

Linhas de cobertura da coleta para os alvos QS 2026, com campos de público, apenas em preparação, ausente, número de fontes, estado de revisão e próxima ação.

Estado das fontes

Metadados de integridade das fontes e da obtenção para instantâneos de fontes já publicados e execuções em preparação. Usados para planejar reparos, não para publicar afirmações.

Fila de revisão

Metadados de execuções em preparação ainda não publicadas com estado de validação, abrangência das fontes, identificadores de URL detectados e próxima ação recomendada.

Lançamento de conjunto de dados

Manifesto de versão com artefatos, contagens de linhas, tamanhos em bytes, somas de verificação SHA-256, citação e limitações.

Índice de relatórios

Índice de relatórios legíveis por máquina, com URLs dos relatórios, métricas, links de dados, feeds e descoberta para divulgação.

Pacote de divulgação de relatórios

Textos legíveis por máquina para mídia, boletins, e-mails a pesquisadores e redes sociais, com limites de uso explícitos.

Manifesto alfa do MCP

Manifesto de projeto MCP apenas para leitura, com estruturas de ferramentas permitidas, ações proibidas e exemplos de consultas de agentes.

Catálogo de ferramentas MCP

Catálogo alfa de ferramentas MCP apenas para leitura, com esquemas de entrada, campos de saída obrigatórios e modificações estritamente proibidas.

Metadados de citação

Modelos de citação legíveis por máquina, campos obrigatórios, regras de evidência, ressalva sobre direitos das fontes e limite de não aconselhamento.

Índice de contribuição

Metadados apenas para leitura do fluxo de contribuição, URLs de modelos de problemas do GitHub, salvaguardas e regras de publicação.

Requisitos de citação e evidência

Preserve o modelo de evidência ao reutilizar dados públicos.

  • Cite a URL canônica da página juntamente com a URL pública do JSON.
  • Mantenha o URL de origem, idioma, hash de instantâneo, trecho de evidência, confiança e estado de revisão com a reutilização da alegação.
  • O estado de confiança e o estado de revisão são campos separados.
  • A evidência na língua original é canônica.
  • Não apresente como conclusões finais de política as afirmações candidatas geradas automaticamente ou que aguardam revisão.
  • Os pontos finais de contribuição contêm apenas metadados. As submissões públicas criam tarefas de revisão através de modelos de issues do GitHub, e não diretamente como factos de referência.

Contrato de widgets incorporáveis

Os widgets públicos usam o mesmo contrato de API, com CORS ativado para JSON de widgets incorporáveis e pesquisa de entidades.

Código de incorporação de JavaScript

O script de incorporação apresenta um cartão compacto em Shadow DOM e lê apenas o JSON público específico do widget. Liga-se às páginas de referência do rastreador e evita texto de alegações não revistas.

Script/widgets/embed.js

Utilização entre sites

Os endpoints JSON de widgets e o endpoint público de pesquisa de entidades incluem cabeçalhos CORS permissivos para incorporação pública e consulta através do navegador. Outros endpoints públicos da API permanecem em JSON normal de mesma origem (same-origin), salvo documentação em contrário.

CORSWidgets and search

Política de limites de requisições e rastreadores

Esta é uma política pública de uso justo, não um acordo de nível de serviço de uma API paga.

Limite sugerido
60 requests per minute per client for public JSON usage
Cache do cliente
3600 segundos, no mínimo
Utilização em massa
Use dataset release artifacts instead of repeatedly walking per-university endpoints.
Uso de rastreadores (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.