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.

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
• Três desfechos tratados: positivo (constam protestos), negativo (nada consta) e erro/indeterminado (abstém com motivo honesto, 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
• Proxy residencial BR embutido (a origem bloqueia data center) e IP novo por consulta
• Saída em JSON limpo, pronta pra planilha, CRM ou pipeline de dados

Exemplo de input

{
  "documentos": ["47960950000121", "11.222.333/0001-81", "390.533.447-05"],
  "maxItems": 100
}

Exemplo de output

{
  "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	array de strings	Sim	CPF/CNPJ, um por linha. Com ou sem pontuação.
maxItems	integer	Não	Limite de documentos por execução (controle de custo). Padrão 100.
useApifyProxy	boolean	Não	Proxy residencial BR. Obrigatório — data center é bloqueado na origem. Padrão true.
proxyCountry	string	Não	País do proxy residencial. Manter BR.

Campos do resultado

Campo	Descrição
documento / tipo	Documento consultado (só dígitos) e tipo detectado (CPF/CNPJ/INVALIDO).
temProtesto	true (constam), false (nada consta), null (erro/indeterminado).
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	sucesso / invalido / erro + descrição honesta quando não há resultado.

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.
• Sempre confira o campo status: itens com erro/invalido trazem o motivo em vez de dado inventado — trate-os no seu pipeline.
• 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 onboarding 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

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 volta com status: "invalido" e o motivo, sem quebrar a execução.

Por que precisa de proxy residencial? A origem bloqueia IPs de data center e detecta automação. O Actor usa proxy residencial brasileiro e um IP/sessão novos a cada documento para que cada consulta pareça um acesso legítimo.

Quanto custa por consulta? Você paga por documento retornado no dataset (Pay per result). Veja a seção Preço abaixo. Documentos que falham ou são inválidos também contam como item retornado com o motivo — sem cobrança escondida por dado inventado.

Preço

Pague por resultado (Pay per result). Você é cobrado por documento retornado no dataset, positivo ou negativo. Sem assinatura, sem mínimo mensal.

Exemplo: cada consulta (documento retornado no dataset) custa US$ 0,40. Os custos de plataforma (computação + proxy residencial) já entram nesse valor.

Itens com status: "erro" ou "invalido" retornam o motivo em vez de dado — você sempre sabe o que pagou.

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.

---

English summary

Brazil protest / debt check by CPF or CNPJ. This Actor queries CENPROT-SP (the official São Paulo protest registry, IEPTB) and returns, per document, whether the person or company has protested debts, in which notary offices (cartórios) and cities, and how many — a direct credit-risk and default signal for Brazil. Useful for KYB in Brazil, counterparty and vendor risk, credit analysis and onboarding. A programmatic CENPROT lookup (no manual portal work): send a list of CPFs/CNPJs, get structured JSON back. Pay per result.

Changelog

• 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.