​
O problema

“Quero empresas de tecnologia em SP com capital acima de R$100k e os contatos pessoais dos sócios.”
A API de Geração de Leads permite filtrar o banco de 56 milhões de empresas e retornar resultados enriquecidos com dados dos sócios.

​
Filtros Disponíveis

FiltroTipoObrigatórioExemploDescrição
cnaestringSim"6201"Prefixo CNAE (startsWith)
ufstringSim"SP"Unidade federativa
cidadestringNão"São Paulo"Filtra por município (parcial)
portestringNão"Demais"ME, EPP ou Demais
capital_minnumberNão100000Capital social mínimo
capital_maxnumberNão5000000Capital social máximo

​
Exemplo de Request

{
  "filtros": {
    "cnae": "6201",
    "uf": "SP",
    "cidade": "Sao Paulo",
    "porte": "Demais",
    "capital_min": 100000
  },
  "limite": 50,
  "incluir_contatos_socios": true
}

​
Exemplo de Response

{
  "total": 50,
  "filtros_aplicados": { "cnae": "6201", "uf": "SP", "cidade": "Sao Paulo", "porte": "Demais", "capital_min": 100000 },
  "empresas": [
    {
      "cnpj": "12345678000199",
      "razao_social": "Tech Solutions Ltda",
      "nome_fantasia": "TechSol",
      "cnae": "6201-5/00",
      "cnae_descricao": "Desenvolvimento de programas de computador sob encomenda",
      "porte": "Demais",
      "capital_social": 500000,
      "cidade": "Sao Paulo",
      "uf": "SP",
      "telefone": "1133224455",
      "email": "[email protected]",
      "socios": [
        {
          "cpf": "123***901",
          "nome": "Maria Santos",
          "qualificacao": "Socio-Administrador",
          "telefones": ["11987654321"],
          "emails": ["[email protected]"]
        }
      ]
    }
  ]
}

​
Dados por Empresa

CampoDescrição
cnpjCNPJ completo
razao_socialRazão social
nome_fantasiaNome fantasia
cnae / cnae_descricaoCNAE principal + descrição
portePorte da empresa
capital_socialCapital social em reais
cidade / ufLocalização
telefone / emailContato da empresa
socios[]Lista de sócios com qualificação
socios[].telefonesTelefones pessoais (se incluir_contatos_socios=true)
socios[].emailsEmails pessoais (se incluir_contatos_socios=true)

​
Exemplo de Uso

import requests

response = requests.post(
    "https://modulos.sherlocker.dev/leads/gerar",
    params={"token": "SEU_TOKEN"},
    json={
        "filtros": {"cnae": "6201", "uf": "SP", "capital_min": 100000},
        "limite": 20,
        "incluir_contatos_socios": True
    }
)

for empresa in response.json()["empresas"]:
    print(f"{empresa['razao_social']} - Capital: R${empresa['capital_social']:,.0f}")
    for socio in empresa["socios"]:
        print(f"  {socio['nome']} ({socio['qualificacao']})")
        if "telefones" in socio:
            print(f"    Tel: {', '.join(socio['telefones'])}")

​
APIs utilizadas

Gerar Leads

Filtragem B2B por CNAE/UF/porte

Empresas

Dados cadastrais PJ

Pessoas

Contatos dos sócios

​
Limites

  • Max limite: 500 empresas por request
  • Apenas empresas com situacao_cadastral = 02 (ativas)
  • CPF dos sócios retornado parcialmente mascarado (123***901)