Preço de consulta de CPF e CNPJ via API: o que compõe a conta

O preço por consulta varia porque quase nada dele é a consulta em si. Origem do dado, profundidade da base, enriquecimento, degrau de volume, franquia mínima e critério de cobrança respondem pela maior parte da diferença entre duas propostas.

Quem pede orçamento pela primeira vez recebe números que parecem incomparáveis. Um fornecedor cobra centavos por chamada e outro cobra várias vezes mais pela mesma "consulta de CPF". Os dois podem estar certos, porque a palavra consulta cobre coisas muito diferentes: de um retorno de situação cadastral até um pacote com vínculo societário, endereço histórico e indicadores de risco. A conta tem poucos componentes e todos podem ser perguntados. O que custa caro é assinar sem perguntar.

Por que a mesma consulta custa centavos em um lugar e reais em outro

A primeira variável é a origem do dado. Consultar uma base oficial tem custo de acesso definido pelo detentor, e esse custo é repassado. O Serpro, por exemplo, publica o valor do Datavalid por faixa de consumo na Loja Serpro e oferece avaliação de até 30 dias ou 3.000 consultas, o que vier primeiro (Serpro, 2026). Quem revende acesso oficial parte desse piso. Quem trabalha com base própria consolidada parte de outro.

A segunda variável é a profundidade. Situação cadastral de CPF é um campo. Quadro societário com histórico, participação cruzada e situação em cada estado é outra coisa, e por isso a consulta de CNPJ voltada a KYB raramente cabe na mesma faixa da consulta de pessoa física.

A terceira é o enriquecimento. Cada camada adicional (telefone, endereço, renda presumida, vínculo empresarial) costuma ser cobrada como item separado, mesmo aparecendo consolidada na resposta.

Os componentes que formam o preço

• Acesso à fonte. O que é: Custo de consultar a base de origem, oficial ou privada. Como costuma ser cobrado: Repassado no preço unitário. Pergunta para a reunião: A consulta vai à fonte a cada chamada ou lê uma cópia?
• Profundidade da base. O que é: Quantidade de campos e histórico retornados. Como costuma ser cobrado: Por produto ou por pacote de campos. Pergunta para a reunião: Quais campos vêm no preço base e quais são extras?
• Enriquecimento. O que é: Camadas adicionais sobre o dado principal. Como costuma ser cobrado: Item por item, somado à chamada. Pergunta para a reunião: Cada camada é uma cobrança separada?
• Volume contratado. O que é: Degrau de preço conforme faixa mensal. Como costuma ser cobrado: Preço unitário decrescente por faixa. Pergunta para a reunião: Onde ficam os degraus e o que acontece se eu não atingir?
• Franquia mínima. O que é: Valor mínimo cobrado no mês, usado ou não. Como costuma ser cobrado: Mensal, fixo. Pergunta para a reunião: Sobra de franquia acumula ou expira?
• Critério de cobrança. O que é: Se conta a chamada feita ou só a que retorna dado. Como costuma ser cobrado: Por requisição ou por retorno positivo. Pergunta para a reunião: Consulta sem retorno é cobrada? E erro técnico?
• Taxa por serviço específico. O que é: Adicional em consultas de automação mais cara. Como costuma ser cobrado: Por requisição, fora do degrau de volume. Pergunta para a reunião: Quais produtos têm adicional fora da tabela?
• Ambiente de teste. O que é: Sandbox e consultas de homologação. Como costuma ser cobrado: Gratuito, limitado ou cobrado. Pergunta para a reunião: Quantas chamadas de teste entram sem custo?

As faixas e condições citadas neste artigo vêm da página oficial do Datavalid no portal gov.br e da tabela pública de preços de um fornecedor brasileiro de APIs de consulta, ambas consultadas em outubro de 2026.

O que as tabelas públicas mostram sobre faixa de preço

Na tabela pública de preços de um fornecedor brasileiro de APIs de consulta, atualizada em outubro de 2026, o preço-base é de R$ 0,20 por consulta nas primeiras 500 do mês e cai para R$ 0,05 acima de 100 mil consultas mensais. O padrão é uma escada: o preço unitário cai conforme a faixa mensal sobe.

Duas condições passam despercebidas na proposta. A primeira é a franquia mínima mensal, que nessa mesma tabela é de R$ 100,00 e é cobrada mesmo se você consumir menos. A segunda é o preço adicional por chamada em algumas APIs, que na mesma tabela vai de R$ 0,04 a R$ 0,14 e é cobrado independentemente do volume do mês.

Daí um efeito comum: a empresa contrata pelo preço unitário da última faixa da tabela, opera na primeira e paga muito acima do previsto. A faixa que importa é aquela em que você vai operar nos primeiros seis meses.

Consulta feita ou consulta com retorno positivo

Este é o item que mais muda a conta e o que menos aparece na primeira página da proposta. Há dois modelos. No primeiro, cobra-se toda requisição que sai do seu servidor, inclusive a que retorna "não encontrado" e, em alguns contratos, a que retorna erro. No segundo, cobra-se apenas a consulta que devolve dado útil.

O segundo modelo parece sempre melhor e nem sempre é. Quem cobra só o retorno positivo costuma embutir essa margem no preço unitário, e a conta final pode empatar. O que decide é a sua taxa de retorno em branco, e isso só se descobre medindo a base real em uma prova de conceito. Peça também a política de repetição: se o seu sistema repete a mesma consulta por timeout, você quer saber se cada repetição vira uma cobrança ou se conta uma só.

Como comparar propostas que cobram a mesma coisa com nomes diferentes

Fornecedores diferentes chamam a mesma cobrança de crédito, pacote, requisição, evento, hit, chamada. Comparar rótulo com rótulo não leva a lugar nenhum. O caminho que funciona é reduzir tudo a um número só: custo total do mês para o seu volume real, no seu mix real de consultas. Monte uma planilha com três colunas (volume mensal esperado, mix de produtos, taxa de retorno em branco) e peça que cada fornecedor preencha a mesma linha. Quem se recusa a preencher está te dizendo algo.

Faça o exercício em três cenários: o volume de hoje, o dobro e a metade. Contrato bom só no cenário otimista penaliza você quando o negócio desacelera. A composição completa de custo de verificação está em quanto custa um KYC no Brasil.

Um último ponto: preço por consulta não é custo total de verificação. Consulta barata que devolve dado defasado gera fila de análise manual, e fila tem custo por hora. Esse custo aparece no orçamento de operação, não na fatura do fornecedor.

O que fazer agora

1. Escreva o seu mix real de consultas antes de pedir orçamento: quantas de CPF, quantas de CNPJ, quais camadas de enriquecimento e em que volume mensal.
2. Peça a tabela completa de degraus, a franquia mínima e a lista de adicionais fora da escada de volume.
3. Pergunte por escrito o que é cobrado quando a consulta retorna vazio, quando dá erro técnico e quando há repetição por timeout.
4. Simule a conta do mês em três cenários de volume e compare pelo total, não pelo preço unitário.
5. Meça a sua taxa de retorno em branco em uma prova de conceito antes de escolher o critério de cobrança.

Perguntas frequentes

Quanto custa uma consulta de CPF via API no Brasil? Não há preço único. Na tabela pública de preços de um fornecedor brasileiro de APIs de consulta, atualizada em outubro de 2026, o preço-base vai de R$ 0,20 por consulta nas primeiras 500 do mês a R$ 0,05 acima de 100 mil consultas mensais, com adicional em algumas APIs. Consultas com enriquecimento ou com dado societário tendem a ficar acima disso, porque envolvem mais fontes.

Por que a consulta de CNPJ pode custar mais que a de CPF? Porque a resposta é mais larga. Quadro societário, histórico de alterações, situação em cada estado e vínculos entre empresas vêm de fontes distintas, e cada fonte tem custo próprio de acesso.

O que é franquia mínima e por que ela importa? É o valor mínimo cobrado no mês, mesmo que você consuma menos. Na tabela pública citada neste artigo, ela é de R$ 100,00. Importa porque define o piso da sua conta e porque, dependendo do contrato, a sobra não acumula para o mês seguinte.

É melhor pagar por consulta feita ou por consulta com retorno positivo? Depende da sua taxa de retorno em branco. Cobrança por retorno positivo costuma vir com preço unitário mais alto, então a vantagem só existe se a sua base gerar muitas consultas vazias. Meça antes de decidir.

Para avaliar como isso se aplica à sua operação, fale com o time comercial da Shiel ID.