Pular para o conteúdo

O que dá para fazer com a API?

Consultar empresas por CNPJ com token, contar por região e atividade, e buscar com filtros pelo MCP, em planos pagos.

Revisado em

Antes de começar
Quem integra sistemas (token ou OAuth) · Pela API, com token
O que isso gasta
Chamadas da API do mês: 1 por chamada aceita.
Garantia
Fazer isso nos primeiros 8 dias encerra a garantia da primeira assinatura. Ver regra

A API devolve a ficha de uma empresa em JSON a partir do CNPJ. Você chama de dentro do seu sistema, com um token, sem abrir a plataforma.

O que a API faz

  • Ficha por CNPJ: cadastro, endereço, CNAEs, sócios, contatos extras e comparativos da empresa.
  • Contagens: quantas empresas existem por região e por atividade.

A busca de empresas com filtros não usa token. Ela é feita pelo MCP, com o login da conta. Para escolher entre plataforma, API e MCP, veja plataforma ou API.

Para ver seus assistentes de IA conectados ou desconectar algum, abra Configurações > MCP para IA na plataforma.

Como chamar

Você cria um token e faz um GET com o CNPJ da empresa. A resposta traz os campos descritos em campos da ficha.

Fazer isso nos primeiros 8 dias encerra a garantia da primeira assinatura. Ver regra

Cada chamada autenticada usa 1 da cota mensal de chamadas do seu plano, mesmo quando a resposta é 404. Os valores estão em cota e limites.

Sobre os dados

A ficha vem da base da Receita Federal, com os contatos extras da mesma raiz de CNPJ e os que a sua conta cadastrou. Telefones e e-mails da Receita aparecem quando a empresa os declarou, e a presença varia por empresa. Veja de onde vêm os contatos.

Para quem a API serve

  • Cadastro e onboarding: conferir os dados cadastrais de clientes e fornecedores a partir do CNPJ, dentro do ERP ou do CRM.
  • Crédito e compliance: levar situação cadastral, sócios e porte para a análise.
  • Vendas B2B: completar contas já conhecidas com CNAE, endereço, porte e contatos.

Dúvidas comuns

O que posso consultar pela API?

Com token, a ficha de uma empresa pelo CNPJ: cadastro, endereço, CNAEs, sócios, contatos extras e comparativos da empresa. Também as contagens de empresas por região e atividade. A busca de empresas com filtros é pelo MCP, com o login da conta.

A API está disponível em qual plano?

Em todos os planos pagos, sem custo adicional. Cada plano tem uma cota mensal de chamadas e um limite por minuto. Veja os valores em cota e limites.

Qual a diferença entre a API e a plataforma?

A plataforma tem filtros para encontrar empresas e exportar listas. A API consulta uma empresa pelo CNPJ de dentro do seu sistema. Veja quando usar cada uma.

Em que formato a API responde?

Em JSON, com quatro seções: company, socios, contatos_extras e contexto. Os campos estão em campos da ficha.
Voltar para a documentação da API

Não resolveu? Fale com o suporte O suporte atende de segunda a sexta, das 9h às 17h, exceto feriados.