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.api.br/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

25.690 requisições atendidas

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

Desenvolvedores
43
Chaves ativas
58

Requisições por dia

0 5.000 10.000 15.000 20.000 06/08 11/08 16/08 21/08 26/08 31/08 04/09

24.373 em 30 dias · 812/dia em média

Ver dados em tabela (30 dias)
Dia Requisições
06/08 51
07/08 61
08/08 99
09/08 772
10/08 103
11/08 322
12/08 374
13/08 288
14/08 166
15/08 347
16/08 261
17/08 637
18/08 694
19/08 929
20/08 1.205
21/08 1.433
22/08 1.146
23/08 458
24/08 350
25/08 389
26/08 364
27/08 610
28/08 220
29/08 17
30/08 6
31/08 509
01/09 1.547
02/09 10.843
03/09 170
04/09 2

Custo de infraestrutura

R$ 394,10 até agora

desde 07/2026 · R$ 6,72 neste mês

Banco de dados
R$ 149,91
Servidor
R$ 201,26
IA
R$ 5,72
Outros
R$ 37,21

Custo por mês

por serviço, em R$

R$ 0 R$ 200 R$ 400 R$ 600 R$ 800 07/2026 · Banco de dados: R$ 59,88 07/2026 · Servidor: R$ 201,26 07/2026 · IA: R$ 3,03 07/2026 · Outros: R$ 31,67 08/2026 · Banco de dados: R$ 83,44 08/2026 · IA: R$ 2,57 08/2026 · Outros: R$ 5,53 09/2026 · Banco de dados: R$ 6,59 09/2026 · IA: R$ 0,12 09/2026 · Outros: R$ 0,01 10/25 11/25 12/25 01/26 02/26 03/26 04/26 05/26 06/26 07/26 08/26 09/26
Ver dados em tabela
Mês Total
10/25 R$ 0,00
11/25 R$ 0,00
12/25 R$ 0,00
01/26 R$ 0,00
02/26 R$ 0,00
03/26 R$ 0,00
04/26 R$ 0,00
05/26 R$ 0,00
06/26 R$ 0,00
07/26 R$ 295,84
08/26 R$ 91,54
09/26 R$ 6,72

Faturamento real do Google Cloud, líquido de créditos — o registro começa em 09/07/2026, quando o export de faturamento foi ligado. Custo de infraestrutura — não é dado da BNCC.

Apoio financeiro recebido

R$ 0 até agora

nenhum patrocínio, edital ou doação registrado até hoje

A infraestrutura que mantém a BNCC API no ar sai do bolso de quem cuida do projeto. Quando chegar o primeiro apoio, esta seção passa a mostrar quanto foi, de onde veio e no que foi aplicado, 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