Consulta de Protesto SP — CENPROT por CPF/CNPJ

Consulte protestos de títulos por CPF ou CNPJ direto na base oficial do CENPROT SP (Cartórios de Protesto do Estado de São Paulo). Descubra se constam protestos, em quais cartórios e comarcas, e a quantidade — em JSON estruturado, pronto para análise de risco de crédito, cobrança e KYB (verificação de fornecedores).

⚠️ Requer um proxy residencial BR próprio. A origem está atrás do Radware Bot Manager, que bloqueia todo proxy compartilhado — inclusive o Apify Proxy. Você precisa informar, no campo Proxy › Custom proxies, um proxy residencial brasileiro de IP limpo. Sem isso, a execução falha na hora e não cobra nada. Detalhes no fim, em Por que precisa de proxy próprio.

Precisa de uma versão pronta pra usar, sem configurar proxy? Fale comigo pelo e-mail em Contato — monto uma solução exclusiva pra sua operação.

Visão geral

Este Actor automatiza a consulta gratuita e anônima do protestosp.com.br. Você informa uma lista de documentos; o Actor detecta CPF ou CNPJ automaticamente, consulta cada um na base do IEPTB-SP e devolve um item por documento no dataset, com a situação de protesto e o detalhamento por cartório.

Ideal para análise de crédito e due diligence: checar a saúde financeira e a inadimplência de clientes, fornecedores e parceiros antes de conceder crédito, prazo ou fechar contrato — sem abrir o site manualmente, documento por documento. O protesto é um dos sinais mais diretos de inadimplência de uma pessoa ou empresa.

Funcionalidades

• Detecção automática de CPF (11 dígitos) e CNPJ (14 dígitos) — com ou sem pontuação
• Dois resultados cobráveis: positivo (constam protestos) e negativo (nada consta) — ambos entram no dataset. Documento inválido ou consulta que falha fica só no log, com motivo honesto, e não é cobrado (nunca inventa dado)
• Tabela paginada de cartórios lida por completo (estado, comarca, cartório, quantidade) — percorre todas as páginas do resultado
• Protocolo oficial da consulta e abrangência da base em SP
• Você usa seu próprio proxy residencial BR (IP limpo) — o Actor consome um IP novo por consulta a partir do que você informa
• Saída em JSON limpo, pronta pra planilha, CRM ou fluxo de dados

Exemplo de entrada

{
  "documentos": ["47960950000121", "11.222.333/0001-81", "390.533.447-05"],
  "maxItems": 100,
  "proxy": {
    "useApifyProxy": false,
    "proxyUrls": ["http://usuario:senha@host:porta"]
  }
}

Exemplo de saída

{
  "documento": "47960950000121",
  "tipo": "CNPJ",
  "temProtesto": true,
  "qtdeTotal": 115,
  "valorTotal": null,
  "cartorios": [
    { "estado": "SP", "comarca": "BARUERI", "cartorio": "1 TABELIAO DE NOTAS E DE PROTESTO DE LETRAS E TITULOS", "qtde": 4, "valor": null },
    { "estado": "SP", "comarca": "FRANCA", "cartorio": "2 TABELIAO DE NOTAS E DE PROTESTO DE LETRAS E TITULOS", "qtde": 14, "valor": null }
  ],
  "protocolo": "0147603092",
  "abrangencia": "100%",
  "paginasLidas": 5,
  "resultadoUrl": "https://protestosp.com.br/consulta-de-protesto/Positivo",
  "status": "sucesso",
  "motivo": null,
  "dataConsulta": "2026-07-05T08:30:58.168Z"
}

Documento limpo retorna temProtesto: false, qtdeTotal: 0 e resultadoUrl terminando em /Negativo.

Tabela de parâmetros

Campo	Tipo	Obrigatório	Descrição
documentos	Lista de textos	Sim	CPF/CNPJ, um por linha. Com ou sem pontuação.
maxItems	Número	Não	Limite de documentos por execução (teto de custo). Padrão 100.
proxy	Configuração de proxy	Sim	Proxy residencial BR próprio. Escolha "Custom proxies" e informe seus endereços (http://usuario:senha@host:porta). Sem isso a execução falha na hora, sem cobrar.

Campos do resultado

Campo	Descrição
documento / tipo	Documento consultado (só dígitos) e tipo detectado (CPF/CNPJ/INVALIDO).
temProtesto	true (constam protestos) ou false (nada consta). Todo item do dataset é um desses dois resultados.
qtdeTotal	Soma das quantidades de protesto em todos os cartórios.
valorTotal	Valor total quando exposto (a consulta gratuita traz só quantidade → normalmente null).
cartorios[]	Estado, comarca, cartório e quantidade de protestos por cartório.
protocolo	Número de protocolo oficial da consulta no CENPROT.
abrangencia	Percentual de abrangência da base em SP (ex.: 100%).
status / motivo	Itens do dataset trazem sempre status: "sucesso" (resultado entregue). Documentos inválidos (invalido) e falhas (erro) não entram no dataset — só no log da execução, com o motivo.

Dicas

• Envie os documentos em lote — um por linha no campo documentos. O Actor consulta cada um com IP e sessão limpos, evitando o bloqueio por consultas repetidas do CENPROT.
• Com ou sem máscara funciona: 47.960.950/0001-21 e 47960950000121 dão o mesmo resultado.
• Use maxItems para teto de custo em bases grandes.
• Todo item do dataset é um resultado entregue (status: "sucesso"), positivo ou negativo. Documentos inválidos e consultas que falham ficam só no log da execução, com o motivo — sem entrar no dataset e sem cobrança.
• Use um proxy residencial BR de IP limpo. A qualidade do proxy decide se a consulta passa: IP residencial genuíno passa; proxy de datacenter ou de pool compartilhado comum é barrado pelo anti-bot da origem. Um IP móvel (4G/5G) BR é o mais robusto.
• Consulta que não resolve é repetida sozinha. Quando a origem devolve a página sem desfecho, o Actor tenta o mesmo documento até 3 vezes, com um IP novo do seu proxy a cada tentativa. Se nenhum documento válido resolver, a execução falha com a explicação — nunca termina como sucesso entregando um resultado vazio.
• A consulta cobre os últimos 5 anos no estado de SP. Não substitui a certidão oficial de protesto.

Casos de uso

• Análise de risco de crédito — cheque protestos antes de conceder crédito, prazo ou limite a um cliente PJ/PF.
• KYB e entrada de fornecedores — due diligence de CNPJ na etapa de cadastro, cruzando protesto com outros sinais.
• Cobrança e recuperação — priorize a carteira por situação de protesto; foque nos casos com mais títulos protestados.
• Antifraude e prevenção — combine protesto com dados cadastrais para pontuar o risco de um documento.
• Monitoramento periódico — reconsulte uma base de clientes de tempos em tempos e detecte novos protestos.
• Pesquisa e compliance — levante a situação de protesto de uma lista de empresas para relatórios internos.

FAQ

Como leio o resultado de cada documento? Olhe o campo temProtesto: true constam protestos (confira qtdeTotal e cartorios[]), false nada consta. Os dois resultados — positivo e negativo — vêm sempre no mesmo formato no dataset e nunca quebram a execução. Documentos inválidos ou consultas que falham não entram no dataset; aparecem só no log da execução, com o motivo.

A consulta é oficial? Os dados vêm da base do IEPTB-SP (Instituto de Estudos de Protesto de Títulos do Brasil — Seção São Paulo), a mesma da consulta gratuita pública. É informativa e não substitui a certidão oficial de protesto.

Cobre o Brasil inteiro? Não. Cobre protestos registrados no estado de São Paulo (CENPROT-SP), abrangência dos últimos 5 anos. O campo abrangencia indica a cobertura da base.

A consulta traz o valor de cada protesto? A consulta gratuita do CENPROT expõe a quantidade de protestos por cartório, não o valor individual. Por isso valor/valorTotal costumam vir null. O Actor não inventa valor.

Funciona para CPF e CNPJ? Sim. O tipo é detectado automaticamente pelo comprimento (11 = CPF, 14 = CNPJ). Documento fora desses formatos é marcado como invalido e registrado no log da execução com o motivo — não entra no dataset e não é cobrado, sem quebrar a execução.

Por que precisa de proxy próprio? A origem está atrás do Radware Bot Manager, que avalia a reputação do IP e trata todo proxy compartilhado — datacenter e o pool residencial do próprio Apify Proxy — como robô, respondendo com um desafio hCaptcha em vez do resultado. Medimos isso diretamente: da mesma máquina e com o mesmo código, um IP residencial genuíno retorna a consulta normalmente, enquanto os IPs de proxy compartilhado batem no muro. Por isso o Actor exige o seu proxy residencial BR de IP limpo — é o que faz cada consulta parecer um acesso legítimo. Ele consome um IP novo do seu proxy a cada documento.

Onde consigo um proxy residencial BR? Qualquer provedor de proxy residencial ou móvel (4G/5G) brasileiro serve, desde que forneça IP limpo no formato http://usuario:senha@host:porta. Vários vendem por GB, sem assinatura. Evite proxies de datacenter — são bloqueados pela origem.

Quanto custa por consulta? Você paga por documento com resultado entregue — positivo (constam protestos) ou negativo (nada consta) — a US$ 0,40 cada (Pay per result). Veja a seção Preço abaixo. Documentos inválidos ou consultas que falham NÃO entram no dataset e NÃO são cobrados: aparecem só no log da execução, com o motivo.

Preço

Pague por resultado (Pay per result). Você paga por documento com resultado entregue — protesto encontrado (positivo) ou nada consta (negativo), US$ 0,40 cada. Documentos inválidos (invalido) ou consultas que falham (erro) NÃO entram no dataset e NÃO são cobrados — aparecem apenas no log. Sem assinatura, sem mínimo mensal.

O valor de US$ 0,40 cobre o processamento no Apify. O custo do proxy residencial é à parte e corre pela sua conta no provedor de proxy que você usar — o consumo é baixo (a consulta transfere uma fração de MB por documento).

Actors relacionados

Da mesma suíte de dados brasileiros (100% PT-native):

• Consulta CNPJ em Lote — Dados da Receita Federal — razão social, sócios, CNAE, endereço e situação cadastral por CNPJ.
• Reclame Aqui Scraper — Reputação de Empresas BR — nota, reclamações e % de resolução no Reclame Aqui.
• Brazil Due Diligence — CNPJ + Reclame Aqui — cadastro da Receita + reputação do consumidor num só item, casado por CNPJ.

Combine este Actor de protesto com o de CNPJ para um dossiê de risco completo por documento.

Changelog

• 0.3 (17/08/2026) — Proxy próprio obrigatório. A origem passou a operar atrás do Radware Bot Manager, que bloqueia todo proxy compartilhado (incluindo o Apify Proxy residencial). Medição controlada confirmou: só IP residencial genuíno passa. Agora o Actor exige um proxy residencial BR próprio (campo Proxy › Custom proxies) e falha na hora, sem cobrar e sem gastar compute, quando ele não é informado — em vez de tentar o Apify Proxy e falhar depois. Removidos os campos useApifyProxy e proxyCountry (não faziam mais efeito).
• 0.2 (10/08/2026) — Correção de confiabilidade. Antes, quando o CENPROT devolvia a página sem desfecho (reCAPTCHA v3 com score baixo) ou bloqueava o acesso, o Actor desistia do documento na primeira tentativa e seguia adiante: com maxRequestRetries configurado, a repetição nunca chegava a acontecer. Uma execução em que todos os documentos caíssem nesse caso terminava como sucesso com resultado vazio. Agora esses dois casos aposentam a sessão e repetem a consulta com IP novo (3 tentativas por documento), e execução sem nenhum documento resolvido falha com mensagem explicativa em vez de terminar verde e vazia. Cobrança inalterada: só resultado entregue é cobrado.
• 0.1 (2026-07) — Versão inicial. Consulta CPF/CNPJ no CENPROT SP, ramos positivo/negativo/inválido, tabela de cartórios paginada, proxy residencial BR com IP por consulta.

Contato e problemas

Encontrou um bug ou quer um campo novo? Abra uma Issue na página do Actor. Retorno rápido.

Quer uma solução sob medida? Se você precisa de uma versão pronta pra usar (sem configurar proxy), de outra fonte de dados brasileira, ou de um fluxo de dados exclusivo pra sua operação, entre em contato: paulovitor18@gmail.com.