Introdução - EnemHub API

A ENEM API entrega questões do Exame Nacional do Ensino Médio já estruturadas: enunciado, alternativas com a correta marcada, matéria, área e ano. É uma API REST sobre HTTPS, com respostas em JSON e autenticação por API Key.

Precisa de vestibulares também?

A Vestibulares API cobre o ENEM e os principais vestibulares do país, com um endpoint a mais para listar exames e instituições.

Base URL

https://api.enemhub.com.br

Todos os endpoints deste produto ficam sob o prefixo /v1/enem.

Endpoints

Método	Rota	O que faz
`GET`	`/v1/enem/questions`	Lista questões, com filtros e paginação.
`GET`	`/v1/enem/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.

Formato das respostas

Listagens vêm num envelope com data e meta:

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

total é a contagem do conjunto filtrado inteiro, não da página — é com ele que você sabe quantas páginas existem. Já a busca por ID devolve a questão diretamente, sem envelope.

A questão

{
  "id": "9f3c...",
  "year": 2023,
  "difficulty": "Média",
  "statement": "Enunciado da questão...",
  "correctAlternative": "C",
  "exam": { "id": "…", "name": "ENEM 2023", "institution": "INEP" },
  "subject": { "id": "…", "name": "Matemática", "area": "Matemática e suas Tecnologias" },
  "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.

Plano

O acesso ao produto ENEM é gratuito: o plano Free é concedido na criação da conta, sem cartão de crédito e sem prazo de expiração — 5.000 requisições por mês, 10 por minuto e 1 API Key por organização.

Ver planos e assinar

Próximo passo

Quick Start

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

Precisa de vestibulares também?

​Base URL

​Endpoints

​Formato das respostas

​A questão

​Erros

​Plano

Ver planos e assinar

​Próximo passo

Quick Start

Base URL

Endpoints

Formato das respostas

A questão

Erros

Plano

Próximo passo