Investigação Societária: Como buscar empresas por Sócio

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: "Em quais CNPJs esta pessoa (ou esta holding) aparece como sócia?".

Com o Plano Pro da API cnpjob, a Busca por Sócio faz esse caminho inverso: você informa o documento do sócio e recebe as empresas em que ele aparece no quadro societário.

Como a Receita publica o documento do sócio

Antes do código, um detalhe que muda tudo: na base aberta da Receita Federal o CPF de sócio pessoa física vem mascarado (por exemplo ***456789**, só os 6 dígitos do meio). Milhares de pessoas dividem os mesmos 6 dígitos, então o CPF sozinho não identifica ninguém. Por isso o endpoint /socio/busca funciona assim:

• Sócio pessoa jurídica: envie o CNPJ completo em cpf_cnpj (14 dígitos). O CNPJ vem inteiro na base, então a busca é exata.
• Sócio pessoa física: envie o CPF em cpf_cnpj (11 dígitos) e o nome completo em nome. A API reduz o CPF à mesma máscara da Receita e usa o nome para separar homônimos de documento. Acentos e maiúsculas não importam.

Não existe busca só por nome: sem o documento, homônimos (há milhares de "José da Silva") tornariam o resultado inútil para compliance.

Caso de uso na prática (Python)

import os, requests

BASE = "https://api.cnpjob.com.br"
HDR  = {"X-API-Key": os.getenv("CNPJOB_KEY")}

# Pessoa física: CPF + nome completo
params = {"cpf_cnpj": "123.456.789-09", "nome": "Carlos Eduardo Ferreira"}

r = requests.get(f"{BASE}/socio/busca", headers=HDR, params=params, timeout=15)
r.raise_for_status()
data = r.json()

print(f"{data['total']} empresa(s) com {data['nome']} no quadro societário:\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(f"Qualificação: {empresa['qualificacao_desc']} desde {empresa['data_entrada_sociedade']}")
    print("-" * 40)

# Pessoa jurídica (holding sócia de outras empresas): só o CNPJ
holding = requests.get(f"{BASE}/socio/busca", headers=HDR,
                       params={"cpf_cnpj": "11222333000181"}, timeout=15).json()

Para descobrir o CPF mascarado e o nome exato de um sócio a partir de uma empresa que você já conhece, use GET /cnpj/:cnpj/socios (disponível em todos os planos): cada sócio vem com nome, cpf_cnpj e qualificacao.

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ê pega o documento do sócio administrador em /cnpj/:cnpj/socios e descobre as outras empresas do mesmo dono para realizar um "Upsell cruzado".