Introdução - EnemHub API

A Vestibulares API entrega questões do ENEM e dos principais vestibulares brasileiros, já estruturadas: enunciado, alternativas com a correta marcada, matéria, área, ano e o exame de origem.

Só precisa do ENEM?

A ENEM API cobre exclusivamente o ENEM, no plano gratuito.

Base URL

https://api.enemhub.com.br

Os endpoints deste produto ficam sob o prefixo /v1/vestibulares.

Endpoints

Método	Rota	O que faz
`GET`	`/v1/vestibulares/exams`	Lista os exames e instituições do catálogo.
`GET`	`/v1/vestibulares/questions`	Lista questões, com filtros e paginação.
`GET`	`/v1/vestibulares/questions/{id}`	Uma questão pelo ID, com alternativas.

A referência completa, com playground para testar cada rota com a sua própria chave, está em API Reference.

Este produto inclui o ENEM. O ENEM aparece em /exams como mais um exame, e as questões dele saem normalmente na listagem — filtre por examId se quiser apenas uma instituição.

Formato das respostas

Listagens de questões vêm num envelope com data e meta:

{
  "data": [ /* ... */ ],
  "meta": { "page": 1, "limit": 20, "total": 41209 }
}

total é a contagem do conjunto filtrado inteiro, não da página. /exams devolve { "data": [...] } sem meta — o catálogo de exames não é paginado. E a busca por ID devolve a questão diretamente, sem envelope.

O exame

{
  "id": "3b1e...",
  "name": "FUVEST 2023",
  "institution": "USP",
  "type": "vestibular"
}

A questão

{
  "id": "9f3c...",
  "year": 2023,
  "difficulty": "Média",
  "statement": "Enunciado da questão...",
  "correctAlternative": "C",
  "exam": { "id": "3b1e...", "name": "FUVEST 2023", "institution": "USP" },
  "subject": { "id": "…", "name": "Biologia", "area": "Ciências da Natureza" },
  "alternatives": [
    { "id": "…", "letter": "A", "text": "…", "isCorrect": false },
    { "id": "…", "letter": "C", "text": "…", "isCorrect": true }
  ]
}

difficulty vem em português: "Fácil", "Média" ou "Difícil" — é o mesmo valor que o filtro difficulty da listagem espera.

statement é HTML, não texto puro — pode conter <p>, <br> e, em cerca de 1 em cada 3 questões, uma imagem embutida como <figure><img src="..."></figure>. Não existe um campo imageUrl separado: a imagem sempre vem dentro do próprio statement. Renderize como HTML sanitizado, não como texto — veja Exemplos. text das alternativas, por outro lado, é sempre texto puro.

subject é anulável — nem toda questão tem matéria classificada. alternatives vem sempre ordenado por letra.

Erros

Status	`error`	Quando acontece
`401`	`Unauthorized`	Header `X-API-Key` ausente, ou chave inválida, revogada ou expirada.
`403`	`Forbidden`	A chave é de outro produto, ou a organização não tem assinatura ativa.
`404`	—	O recurso não existe, ou não pertence ao produto da sua chave.
`429`	`Too Many Requests`	Estourou o limite por minuto, por dia ou a cota mensal do plano.
`500`	—	Erro interno. Se persistir, fale com o suporte.

O corpo do erro não é uniforme em toda a API — documentamos o que existe hoje, não o que gostaríamos que existisse.As rotas de gestão devolvem { "error", "message", "statusCode" }. Os erros de autenticação e de rate limit devolvem { "error", "message" }, sem statusCode. E o 404 das rotas de questão devolve só { "error": "Questão não encontrada" }.Ou seja: trate pelo status HTTP, que é consistente, e use error / message apenas para exibir ou registrar em log.

Planos

Plano	Preço	Requisições/mês	Por minuto	API Keys
Starter	R$ 149/mês	50.000	60	2
Pro	R$ 399/mês	500.000	300	10
Business	R$ 1.490/mês	5.000.000	1.000	50
Enterprise	sob consulta	negociado	negociado	ilimitadas

Ver planos e assinar

Próximo passo

Quick Start

Da criação da conta à primeira questão na tela, em quatro passos.

Só precisa do ENEM?

​Base URL

​Endpoints

​Formato das respostas

​O exame

​A questão

​Erros

​Planos

Ver planos e assinar

​Próximo passo

Quick Start

Base URL

Endpoints

Formato das respostas

O exame

A questão

Erros

Planos

Próximo passo