BNCC API

A BNCC inteira, palavra por palavra.

1.721 habilidades das três etapas, com o código e o texto do documento oficial. Grátis, aberta e com as contas na mesa.

Criar minha chave grátis Ler o guia

Sem cartão e sem fila de aprovação. A chave sai na hora.

GET /api/v1/habilidades/EF05MA07 200 
{
  "codigo": "EF05MA07",
  "descricao": "Resolver e elaborar problemas
    de adição e subtração com números
    naturais e com números racionais…",
  "etapa": "ensino_fundamental",
  "anos": ["5"],
  "componente": "matematica",
  "unidade_tematica": "Números"
}

A base inteira, da creche ao terceiro ano

1.721

habilidades catalogadas, nas três etapas

Inclui as 141 habilidades do Complemento de Computação, que passa a ser obrigatório em 2026, com os eixos de Educação Infantil e Fundamental já estruturados. Os números vêm do snapshot versionado: quando a base muda, este parágrafo muda junto.

Como você sabe que o texto está certo

Porque dá para conferir. Modelos de linguagem inventam código de habilidade com uma confiança desconfortável, e planilha montada à mão envelhece sozinha. A extração aqui é auditada, e a auditoria é pública.

  • Extração determinística

    O snapshot sai dos PDFs oficiais por script versionado. Rodar de novo produz exatamente o mesmo arquivo.

  • Conferido contra duas testemunhas independentes

    As descrições foram cruzadas com o documento oficial completo e com um dataset independente da versão homologada. Isso corrigiu 59 descrições que a extração havia embaralhado entre colunas do PDF, e recuperou uma habilidade que faltava, a EF05CO11.

  • Auditoria no portão de teste

    Um script versionado procura truncamento, contaminação entre células e fusão de texto a cada mudança. Hoje ele fecha com 0 achados de erro, e o teste quebra se isso deixar de ser verdade.

  • O que a IA escreve vem etiquetado

    A busca semântica devolve as fontes oficiais junto com a resposta, e todo texto gerado sai marcado como não-oficial. Se a camada de IA cair, consulta por código, filtros, relações e taxonomia seguem de pé.

Da conta à primeira chamada

  1. Crie a conta

    E-mail e senha, verificação, pronto. Sem aprovação manual e sem cartão.

  2. Gere a chave

    Crie e revogue API keys quando quiser, no portal, acompanhando o uso.

  3. Chame a API

    Endpoints REST sob /api/v1, documentados no OpenAPI.

curl -H "Authorization: Bearer SUA_API_KEY" \
  "https://bncc.amsyslab.net/api/v1/habilidades?etapa=ensino_fundamental&ano=5"

O que dá para construir

Cinco usos ancorados em problemas reais das escolas e redes do Brasil.

As contas abertas

Quanto a plataforma é usada e quanto custa mantê-la no ar. Números agregados, sem login, atualizados a cada 10 minutos.

Uso da plataforma

1 requisições atendidas

desde 11/2026 · só o total — nada por usuário, chave ou IP

Desenvolvedores
1
Chaves ativas
1

Requisições por dia

0 1 2 3 4 07/10 12/10 17/10 22/10 27/10 01/11 05/11

1 em 30 dias · 0/dia em média

Ver dados em tabela (30 dias)
Dia Requisições
07/10 0
08/10 0
09/10 0
10/10 0
11/10 0
12/10 0
13/10 0
14/10 0
15/10 0
16/10 0
17/10 0
18/10 0
19/10 0
20/10 0
21/10 0
22/10 0
23/10 0
24/10 0
25/10 0
26/10 0
27/10 0
28/10 0
29/10 0
30/10 0
31/10 0
01/11 0
02/11 0
03/11 0
04/11 0
05/11 1

Apoio financeiro recebido

R$ 400 até agora

1 patrocínio de empresa · aplicado na infraestrutura

O primeiro apoio veio de uma empresa que preferiu não ser identificada. Os R$ 400 foram aplicados na infraestrutura do Google Cloud, a mesma fatura que aparece no painel de custos. O restante continua saindo do bolso de quem cuida do projeto. Cada novo apoio entra aqui com a mesma auditoria pública que já vale para os custos.

Se ela te poupou tempo, ajude a manter

GitHub Sponsors

Apoio avulso ou mensal no cartão internacional, sem taxa de plataforma.

Apoiar no GitHub Sponsors

Uma estrela no repositório

Não custa nada e ajuda o projeto a chegar a mais gente que constrói educação no Brasil.

Ver o repositório

Pix

Aponte a câmera para o QR Code ou copie o código e cole em Pix › Copia e Cola. Você escolhe o valor.

QR Code Pix para apoiar o projeto
00020126360014BR.GOV.BCB.PIX0114+55719990084435204000053039865802BR5913FABIO SANTANA6006BRASIL62110507BNCCAPI63040E12

Quem mantém

A BNCC API é criada e mantida pela Expertia e pela EuMaker, de Fábio Santana — no Brasil, para quem constrói educação no Brasil. Código aberto sob licença MIT, contribuições bem-vindas.

Iniciativa independente e não-oficial, sem vínculo com o MEC. Os textos de habilidades e competências reproduzem fielmente os documentos oficiais da BNCC; conteúdo gerado por IA é sempre marcado como não-oficial.

Perguntas frequentes

A BNCC API é oficial do MEC?

Não. É uma iniciativa independente e open-source, sem vínculo com o MEC. Os textos de habilidades e competências reproduzem fielmente os documentos oficiais da BNCC, e conteúdo gerado por IA é sempre marcado como não-oficial.

Quanto custa usar a API?

Nada. Conta, API key e todos os endpoints são gratuitos, com cota de 60 requisições por minuto nos endpoints determinísticos. O projeto se mantém por apoio voluntário via GitHub Sponsors e Pix.

Posso usar em um produto comercial?

Sim. O código é aberto sob licença MIT e os dados da BNCC são públicos. Só pedimos que deixe claro aos seus usuários que a iniciativa não tem vínculo com o MEC.

A base de habilidades está completa?

Sim: 1.721 habilidades cobrindo Educação Infantil, Ensino Fundamental e Ensino Médio, incluindo as 141 do Complemento de Computação. O snapshot é versionado e a extração é determinística, reproduzível e auditada.

E se a camada de IA sair do ar?

Os endpoints determinísticos não dependem do LLM: consulta por código, filtros, relações e taxonomia continuam funcionando. A busca semântica é opcional e degrada com elegância.

Qual a cota e o que acontece se eu estourar?

São 60 requisições por minuto nos endpoints determinísticos. Ao estourar, a API responde 429 com o cabeçalho de espera; nada é bloqueado em definitivo. Se o seu caso precisa de mais, abra uma issue no repositório e conversamos.

Sua primeira chamada sai em minutos

Conta gratuita, chave na hora e toda a BNCC à disposição do seu produto.

Criar minha chave grátis Ler o guia