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

30.571 requisições atendidas

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

Desenvolvedores
65
Chaves ativas
91

Requisições por dia

0 500 1.000 1.500 2.000 20/09 25/09 30/09 05/10 10/10 15/10 19/10

4.545 em 30 dias · 152/dia em média

Ver dados em tabela (30 dias)
Dia Requisições
20/09 373
21/09 62
22/09 2
23/09 345
24/09 70
25/09 49
26/09 1
27/09 0
28/09 60
29/09 22
30/09 169
01/10 428
02/10 87
03/10 185
04/10 120
05/10 61
06/10 280
07/10 70
08/10 13
09/10 3
10/10 67
11/10 244
12/10 20
13/10 296
14/10 528
15/10 92
16/10 48
17/10 320
18/10 209
19/10 321

Custo de infraestrutura

R$ 531,60 até agora

desde 07/2026 · R$ 56,64 neste mês

Banco de dados
R$ 273,20
Servidor
R$ 201,26
IA
R$ 11,77
Outros
R$ 45,37

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$ 81,75 09/2026 · IA: R$ 0,44 09/2026 · Outros: R$ 5,39 10/2026 · Banco de dados: R$ 48,13 10/2026 · IA: R$ 5,73 10/2026 · Outros: R$ 2,78 11/25 12/25 01/26 02/26 03/26 04/26 05/26 06/26 07/26 08/26 09/26 10/26
Ver dados em tabela
Mês Total
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$ 87,58
10/26 R$ 56,64

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$ 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