Saber de quais empresas uma pessoa (ou outra empresa) é dona é uma das informações mais valiosas do mercado corporativo. Processos de Background Check, análise de concessão de crédito, prevenção a fraudes (KYB - Know Your Business) e até prospecção de vendas B2B dependem desse cruzamento de dados.
O Desafio do Mapeamento Societário
Normalmente, as APIs gratuitas fornecem apenas a rota de "Quem são os sócios do CNPJ X". Isso resolve apenas metade do problema. A verdadeira inteligência está no caminho inverso: "Quais são todos os CNPJs em que o 'João da Silva' (ou CPF ***.123.456-**) é sócio?".
Com o Plano Pro da API cnpjob, a funcionalidade de Busca por Sócio resolve exatamente essa dor em tempo real.
Caso de Uso na Prática (Python)
No exemplo abaixo, usamos Python para consultar o endpoint /socio/busca. Você pode pesquisar usando o Nome Completo ou uma busca aproximada do documento.
import requests
API_KEY = "sua_api_key_aqui"
NOME_SOCIO = "Carlos Eduardo Ferreira"
url = "https://api.cnpjob.com.br/api/socio/busca"
headers = {"X-API-Key": API_KEY}
params = {"q": NOME_SOCIO}
response = requests.get(url, headers=headers, params=params)
data = response.json()
print(f"Encontramos {data['total']} empresas vinculadas ao sócio {NOME_SOCIO}:\n")
for empresa in data["empresas"]:
print(f"CNPJ: {empresa['cnpj']}")
print(f"Razão Social: {empresa['razao_social']}")
print(f"Situação: {empresa['situacao']}")
print("-" * 40)
Aplicações Comuns (Feature Pro)
- Prevenção a Fraude: O cliente solicitando crédito na sua plataforma possui histórico de falências em outros CNPJs no nome dele?
- Vendas Direct-to-CEO: Se você identificou um CNPJ alvo que é holding, você busca pelo Sócio Administrador e descobre todas as outras filiais e empresas operacionais do mesmo dono para realizar um "Upsell cruzado".