# Busca Empresas por Nome do Sócio (`brasildados/busca-empresas-por-nome-socio`) Actor

Descubra todas as empresas vinculadas a uma pessoa pelo nome do sócio, administrador ou representante legal. Retorna CNPJ, razão social, cargo e data de entrada de cada empresa encontrada.

- **URL**: https://apify.com/brasildados/busca-empresas-por-nome-socio.md
- **Developed by:** [BrasilDados.org - Hub de APIs de Dados do Brasil](https://apify.com/brasildados) (community)
- **Categories:** Lead generation, SEO tools, Automation
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$80.00 / 1,000 por sócio encontrados

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

### 🔎 Busca Empresas por Nome do Sócio

Descubra todas as empresas vinculadas a uma pessoa pelo **nome do sócio, administrador ou representante legal**. Informe um nome completo e receba a lista de empresas onde essa pessoa atua ou atuou — CNPJ, razão social, cargo e data de entrada.

> ⚠️ A busca é feita por **termo, não por correspondência exata**. Um nome comum (ex. "Jose da Silva") pode retornar centenas de milhares de pessoas diferentes com nomes parecidos. Use o **nome completo exato** que você procura para reduzir esse ruído, e ajuste `maxNomes` para controlar quantos homônimos você recebe (e paga) por busca.

### O que este Actor retorna

Cada linha do Dataset é **uma pessoa encontrada**, com todas as empresas vinculadas a ela em `empresas[]`.

| Campo | Descrição |
|---|---|
| `nomeBuscado` | Nome exatamente como você informou |
| `nomeEncontrado` | Nome da pessoa conforme cadastro oficial |
| `tipoPessoa` | `FISICA` ou `JURIDICA` (quando o sócio é uma empresa) |
| `documento` | CPF parcialmente mascarado (pessoa física) ou CNPJ completo (pessoa jurídica) |
| `faixaEtaria` | Faixa etária estimada, só para pessoa física |
| `totalEmpresas` | Quantidade de vínculos societários encontrados |
| `empresas[]` | CNPJ raiz, razão social, natureza jurídica, porte, cargo e data de entrada de cada empresa |

### Input

```json
{
  "nomes": ["Gilsomar Maia Sebastiao"],
  "maxNomes": 5
}
```

| Campo | Obrigatório | Padrão | Descrição |
|---|---:|---:|---|
| `nomes` | Sim | — | Um ou mais nomes completos a pesquisar. Até 50 por execução. |
| `maxNomes` | Não | `10` | Máximo de pessoas retornadas para cada nome buscado (1 a 100). |

### Exemplo de resultado real

```json
{
  "nomeBuscado": "Gilsomar Maia Sebastiao",
  "nomeEncontrado": "Gilsomar Maia Sebastiao",
  "tipoPessoa": "FISICA",
  "documento": "***189288**",
  "faixaEtaria": "41-50",
  "totalEmpresas": 38,
  "empresas": [
    {
      "cnpjRaiz": "01723098",
      "razaoSocial": "GESPLAN S/A",
      "naturezaJuridica": "Sociedade Anônima Fechada",
      "porte": "Demais",
      "cargo": "Diretor",
      "desde": "2022-05-27"
    },
    {
      "cnpjRaiz": "02497398",
      "razaoSocial": "TOTVS SERVICOS LTDA",
      "naturezaJuridica": "Sociedade Empresária Limitada",
      "porte": "Demais",
      "cargo": "Administrador",
      "desde": "2016-02-15"
    }
  ],
  "consultadoEm": "2026-08-26T14:10:00.000Z"
}
```

`cnpjRaiz` traz os 8 primeiros dígitos do CNPJ (identifica a empresa, sem o sufixo de filial/matriz).

### Preço

**Cobrança por pessoa entregue no Dataset.** Nome sem nenhuma pessoa correspondente não gera linha e não é cobrado.

### Usar pela API da Apify

```bash
curl -X POST "https://api.apify.com/v2/acts/brasildados~busca-empresas-por-nome-socio/run-sync-get-dataset-items?format=json" \
  -H "Authorization: Bearer SEU_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"nomes":["Gilsomar Maia Sebastiao"],"maxNomes":5}'
```

### Casos de uso

- Due diligence: verificar em quais outras empresas um sócio ou administrador atua.
- Compliance e KYC: mapear a rede societária de uma pessoa antes de fechar negócio.
- Investigação de vínculos entre empresas por sócios em comum.

### Limitações conhecidas

- A busca por nome não é exata: nomes comuns retornam muitos resultados. Use o nome completo mais específico possível.
- CPF é sempre parcialmente mascarado pela própria fonte (LGPD); não é possível obter o CPF completo.
- `cnpjRaiz` é o CNPJ básico (8 dígitos), sem o sufixo de filial.

### Actors relacionados do BrasilDados

- [Enriquecimento de dados por CNPJ](https://apify.com/brasildados/brazil-enrich-data-lead-by-cnpj?fpr=t5lwzq) para consultar uma lista de CNPJs conhecidos.
- [Gerador de Leads por CNAE](https://apify.com/brasildados/gerador-de-leads-scraper-cnae?fpr=t5lwzq) para prospecção por segmento.
- [Todos os Actors do BrasilDados](https://apify.com/brasildados?fpr=t5lwzq) para outras consultas empresariais no Brasil.

### FAQ

#### Por que uma busca por um nome inventado retornou resultados?

A fonte busca por **termos** contidos no nome (não uma correspondência exata da string inteira). Um nome com palavras comuns pode coincidir parcialmente com outros cadastros. Use nomes completos e específicos para reduzir isso.

#### Como faço para achar só uma pessoa específica entre homônimos?

Use o nome completo mais específico possível (com sobrenomes intermediários) e um `maxNomes` baixo. Se ainda houver homônimos, compare `faixaEtaria` e as empresas vinculadas para identificar a pessoa certa.

#### Os dados são atualizados?

Sim, a consulta é feita em tempo real contra a base pública de sócios e administradores (QSA) da Receita Federal.

# Actor input Schema

## `nomes` (type: `array`):

Nome completo de uma ou mais pessoas a pesquisar. Use o nome exato que você procura (nome comum retorna muitos homônimos).

## `maxNomes` (type: `integer`):

Quantidade máxima de pessoas retornadas para cada nome buscado. Nomes comuns podem ter muitos homônimos; use um valor baixo para controlar o custo.

## Actor input object example

```json
{
  "nomes": [
    "Gilsomar Maia Sebastiao"
  ],
  "maxNomes": 5
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "nomes": [
        "Gilsomar Maia Sebastiao"
    ],
    "maxNomes": 5
};

// Run the Actor and wait for it to finish
const run = await client.actor("brasildados/busca-empresas-por-nome-socio").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "nomes": ["Gilsomar Maia Sebastiao"],
    "maxNomes": 5,
}

# Run the Actor and wait for it to finish
run = client.actor("brasildados/busca-empresas-por-nome-socio").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "nomes": [
    "Gilsomar Maia Sebastiao"
  ],
  "maxNomes": 5
}' |
apify call brasildados/busca-empresas-por-nome-socio --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,brasildados/busca-empresas-por-nome-socio"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/yjhzSrSY7Hj0KvnjK/builds/WwJ4uC1Bpw9kNDuXb/openapi.json