Pular para o conteúdo

Plataforma ou API: qual uso?

A plataforma encontra empresas com filtros. A API consulta uma empresa por CNPJ no seu sistema. Veja qual serve ao seu caso.

Revisado em

Antes de começar
Qualquer usuário da conta · Na plataforma · Pela API, com token
O que isso gasta
Cota de exportação do mês, conforme a operação abaixo.Chamadas da API do mês: 1 por chamada aceita.

A plataforma, a API e o MCP usam a mesma base de empresas. O que muda é o jeito de chegar a ela.

Plataforma

É a tela do app, no navegador. Você aplica os filtros (setor, localização, porte, data de abertura e outros), vê as empresas e os gráficos do mercado e exporta a lista. Não exige programação.

Só a plataforma tem a base de obras do CNO, os alertas do Diário Oficial da União e a rede de sócios.

API com token

É uma chamada HTTP do seu sistema. Você manda o CNPJ e recebe a ficha da empresa em JSON. A API também conta empresas por região e atividade, e a contagem aceita filtros. Ela não lista o recorte inteiro: o ranking do recorte traz só as empresas de maior capital social e as abertas mais recentemente numa atividade ou num município.

Serve quando você já sabe quais CNPJs quer consultar e o seu sistema faz isso sozinho. Por exemplo, um ERP que confere o cadastro de um fornecedor ou um CRM que completa os dados de uma conta.

E a busca com filtros fora da plataforma?

É pelo MCP, que conecta o Claude, o ChatGPT ou o Cursor à sua conta. O login é o da conta, sem token. Cada busca e cada consulta de empresa pelo MCP usa 1 da cota mensal de chamadas da API do seu plano.

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

Quando usar cada um

Use a plataforma quando você quer:

  • descobrir empresas e segmentar por filtros;
  • exportar listas para prospecção;
  • acompanhar obras, Diário Oficial e sócios;
  • trabalhar na tela, sem programar.

Use a API quando você quer:

  • consultar uma empresa pelo CNPJ de dentro do seu sistema;
  • conferir ou completar o cadastro de clientes e fornecedores;
  • buscar contagens de empresas por região e atividade pelo seu sistema.

Use o MCP quando você quer pedir a busca em linguagem natural a um assistente de IA.

Usar mais de um

É possível. Uma rotina comum: pesquisar na plataforma, exportar os CNPJs e deixar o seu sistema consultar cada um pela API. O plano é o mesmo, e cada uso gasta o seu saldo: a exportação gasta a cota de exportação. As chamadas da API por token, e no MCP buscar empresas e consultar uma empresa por CNPJ, gastam a cota de chamadas. Os valores estão em planos e preços.

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

Gerar filtro pelo MCP também gasta a cota de chamadas.

Isso não encerra a garantia da primeira assinatura.

Dúvidas comuns

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

Na plataforma você usa filtros, vê os resultados em tela e exporta listas. Na API você manda o CNPJ de uma empresa e recebe a ficha em JSON, dentro do seu sistema.

Posso usar a plataforma e a API ao mesmo tempo?

Pode. A plataforma e a API são da mesma conta e do mesmo plano. A exportação usa a cota de exportação e cada chamada da API usa a cota de chamadas, cada uma com o seu saldo.

Quando devo optar pela API em vez da plataforma?

Quando o seu sistema precisa consultar uma empresa pelo CNPJ sem ninguém abrir a plataforma, como um ERP, um CRM ou um cadastro de clientes. Para descobrir empresas com filtros, use a plataforma.

A API faz busca com filtros?

Com token, não lista o recorte inteiro. A API consulta por CNPJ, conta empresas por região e atividade, com filtros na contagem, e traz um ranking curto do recorte. A busca de empresas com filtros é pelo MCP, com o login da conta.
Voltar para a plataforma

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