API de consulta de CPF: diferenças entre planos gratuito, Pro e Corporate

Quando os créditos do Grátis terminam, a API pausa com HTTP 403 e a mensagem "Limite de créditos excedido". Nos planos pagos a cobrança extra, se o plano tiver excedente, sai na fatura seguinte (veja a página de preços). Requisições além do limite por minuto recebem HTTP 429 com Retry-After. A escolha depende do seu volume mensal de consultas, dos requisitos de SLA e do nível de suporte que a aplicação exige.

Introdução

Escolher o plano certo de uma API de consulta de CPF depende do volume de consultas, das exigências de SLA e do nível de suporte que sua aplicação necessita. A CPFHub.io disponibiliza planos desenhados para atender desde protótipos e projetos pessoais até grandes operações em produção, com preços e limites claros em cada camada.

Visão geral dos planos

Plano Gratuito: para testes e protótipos

O plano Gratuito permite até 50 consultas por mês sem custo algum e sem necessidade de cartão de crédito. Ele é ideal para:

• Validação técnica -- Testar a integração com a API antes de comprometer-se com um plano pago.

• Projetos pessoais -- Aplicações de baixo volume que precisam de consultas esporádicas.

• Provas de conceito -- Demonstrar a viabilidade técnica de uma solução antes de buscar aprovação para investimento.

• Ambiente de sandbox -- Usar como ambiente de testes com dados reais, sem custo.

Limitações do plano Gratuito

• 50 consultas por mês -- Para a maioria das aplicações em produção, esse limite é insuficiente.

• Rate limit de 30 requisições por minuto -- Limita a velocidade de processamento em lote.

• SLA de 80% -- Não há garantia de disponibilidade para uso em produção.

• Suporte apenas por e-mail -- Sem canais prioritários.

Exemplo de consulta no plano Gratuito

A API funciona exatamente da mesma forma em todos os planos. A diferença está nos limites:

curl -X GET https://api.cpfhub.io/cpf/12345678900 \
    -H "x-api-key: SUA_CHAVE_DE_API" \
    -H "Accept: application/json" \
    --max-time 10

{
    "success": true,
    "data": {
    "cpf": "12345678900",
    "name": "João da Silva",
    "nameUpper": "JOÃO DA SILVA",
    "gender": "M",
    "birthDate": "15/06/1990",
    "day": 15,
    "month": 6,
    "year": 1990
    }
}

Plano Pro: para aplicações em produção

O plano Pro é a opção mais popular da CPFHub.io e atende bem a aplicações que já estão em produção e precisam de volume, SLA e suporte superiores aos do plano Gratuito. É indicado para:

• Onboarding de clientes -- Fintechs, e-commerces e plataformas que validam dezenas de CPFs por dia.

• Processos de KYC -- Verificação de identidade como parte do fluxo de cadastro.

• Antifraude -- Validação de CPF no checkout ou em transações financeiras.

• Equipes de desenvolvimento -- Múltiplos desenvolvedores usando a mesma API key em diferentes ambientes.

Vantagens do plano Pro

• 1.000 consultas inclusas -- Suficiente para a maioria das aplicações de médio porte.

• Os 50 créditos do Grátis, ao se esgotarem, pausam o serviço: HTTP 403, "Limite de créditos excedido". Se o plano for pago e prever excedente, o crédito extra é faturado depois, como na página de preços. O teto de chamadas por minuto devolve HTTP 429 e pede espera pelo Retry-After.

• Rate limit de 30 requisições por minuto -- Dobro da velocidade do plano Gratuito.

• SLA de 99% -- Disponibilidade adequada para aplicações em produção.

• Suporte via WhatsApp e e-mail -- Canais mais ágeis para resolver problemas.

• Desconto por volume -- Para clientes com consumo consistentemente alto.

Custo por consulta no plano Pro

Plano Corporativo: para grandes operações

O plano Corporativo é desenhado para empresas com alto volume de consultas e exigências rigorosas de disponibilidade e suporte. Ele oferece:

• Limites personalizados -- Volume de consultas e rate limits definidos conforme a necessidade.

• SLA de 99,9% -- A maior garantia de disponibilidade disponível.

• Infraestrutura exclusiva e escalável -- Recursos dedicados que não são compartilhados com outros clientes.

• Suporte prioritário 24/7 -- Atendimento contínuo via WhatsApp e e-mail.

• Integração consultiva -- Especialistas da CPFHub.io auxiliam na implementação e na otimização do consumo.

• Gerente de conta dedicado -- Ponto de contato direto para questões comerciais e técnicas.

Para quem é o plano Corporativo

• Bancos e instituições financeiras -- Que processam milhares de verificações de CPF por dia.

• Grandes e-commerces -- Com alto volume de transações e necessidade de validação no checkout.

• Plataformas de KYC -- Que oferecem verificação de identidade como serviço para outras empresas.

• Empresas com requisitos de compliance rigorosos -- Que precisam de SLA documentado e suporte dedicado para auditorias.

Quando migrar de plano

Do Gratuito para o Pro

Considere a migração quando:

• Suas 50 consultas mensais não são suficientes para o uso atual.
• Você está movendo a integração de testes para produção.
• Precisa de suporte mais ágil (WhatsApp).
• O SLA de 80% não atende aos requisitos da sua aplicação.

Do Pro para o Corporativo

Considere a migração quando:

• O consumo mensal excede consistentemente 1.000 consultas.
• O custo de consultas adicionais torna o plano Pro mais caro que o Corporativo.
• Sua operação exige SLA de 99,9%.
• Você precisa de infraestrutura dedicada por motivos de compliance.
• Suporte 24/7 é um requisito operacional.

Como calcular qual plano é mais adequado

def calcular_plano_ideal(consultas_mensais):
    custo_gratuito = 0 if consultas_mensais <= 50 else float('inf')

    custo_pro = 149
    if consultas_mensais > 1000:
    custo_pro += (consultas_mensais - 1000) * 0.15

    if consultas_mensais <= 50:
    return {
    "plano_recomendado": "Gratuito",
    "custo": 0,
    "motivo": "Volume dentro do limite gratuito"
    }
    elif consultas_mensais <= 2000:
    return {
    "plano_recomendado": "Pro",
    "custo": custo_pro,
    "motivo": f"Custo estimado: R$ {custo_pro:.2f}/mês"
    }
    else:
    return {
    "plano_recomendado": "Corporativo",
    "custo": "Sob consulta",
    "motivo": "Volume alto justifica infraestrutura dedicada"
    }

# Exemplos
print(calcular_plano_ideal(30)) # Gratuito
print(calcular_plano_ideal(800)) # Pro: R$ 149
print(calcular_plano_ideal(1500)) # Pro: R$ 224
print(calcular_plano_ideal(5000)) # Corporativo

Perguntas frequentes

Qual é a diferença prática entre o plano Gratuito e o Pro?

O plano Gratuito oferece 50 créditos/mês sem custo e sem cartão, com SLA de 80% e suporte apenas por e-mail — ideal para testes e protótipos. Atingir o fim da cota no Grátis devolve HTTP 403 ("Limite de créditos excedido") e interrompe novas consultas. Nos planos pagos, havendo excedente, ele é faturado depois conforme a página de preços. O limite por minuto não entra nessa conta: é HTTP 429 com Retry-After.

O que acontece quando eu esgoto as consultas do meu plano?

No plano Gratuito, as consultas extras não estão disponíveis — o limite é fixo em 50/mês. No Grátis, esgotar essa cota pausa as consultas: a API responde HTTP 403 com "Limite de créditos excedido". Nos planos pagos, o excedente — quando o plano inclui — entra na fatura seguinte, no valor da página de preços. O limite por minuto é outro e devolve HTTP 429 com Retry-After. O valor excedente é consolidado na próxima fatura.

Como garantir conformidade com a LGPD ao usar uma API de CPF?

Use o CPF apenas para a finalidade declarada ao titular, armazene apenas o necessário (não guarde o CPF cru se um token bastar), implemente controle de acesso aos logs de consulta e documente a base legal para o tratamento. A ANPD orienta que dados de identificação devem ser tratados com o princípio da necessidade.

Quanto tempo leva para integrar a API CPFHub.io?

A integração básica leva menos de 30 minutos: crie uma conta em cpfhub.io, gere a API key no painel e faça uma chamada GET para https://api.cpfhub.io/cpf/{CPF} com o header x-api-key. A documentação inclui exemplos em Python, Node.js, PHP, Java e outras linguagens.

Conclusão

Os três planos da CPFHub.io foram desenhados para acompanhar o crescimento da sua aplicação: comece gratuitamente, migre para o Pro quando a produção exigir SLA e volume maiores, e negocie o Corporativo quando a operação demandar infraestrutura dedicada e suporte 24/7.

Cadastre-se em cpfhub.io — 50 consultas mensais gratuitas, sem cartão de crédito — e escolha o plano que acompanha o crescimento do seu volume de consultas.