# Gerador de Leads por CNAE - Busque Empresas por Segmento (`brasildados/gerador-de-leads-scraper-cnae`) Actor

Gere listas de leads B2B pesquisando empresas brasileiras por CNAE, estado, porte e situação cadastral. Encontre CNPJ, razão social, nome fantasia, atividade, contatos, endereço protegido e sócios com documentos mascarados. Exporte em JSON, CSV ou Excel e integre via API Batch ou Standby.

- **URL**: https://apify.com/brasildados/gerador-de-leads-scraper-cnae.md
- **Developed by:** [BrasilDados.org](https://apify.com/brasildados) (community)
- **Categories:** Lead generation, Automation, Other
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $80.00 / 1,000 por lead encontratoes

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#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

### 🔎 Gerador de Leads por CNAE e Consulta CNPJ em Lote

O **Gerador de Leads por CNAE** faz **consulta CNPJ em lote** pelo segmento de atividade econômica e cria listas estruturadas para prospecção B2B. Informe um ou mais códigos CNAE e receba empresas com CNPJ, razão social, nome fantasia, situação cadastral, porte, contatos, localização e quadro societário.

Você pode filtrar por **estado**, **porte da empresa** e **situação cadastral**. O padrão pesquisa empresas ativas e o input já vem preenchido para que a primeira execução seja simples, rápida e útil.

#### O que este scraper de empresas por CNAE faz?

- 🎯 Gera leads por CNAE principal, segmento ou atividade econômica.
- 🗺️ Pesquisa em todo o Brasil ou filtra por estado.
- 🏢 Filtra microempresas, empresas de pequeno porte e demais portes.
- 📊 Exporta os resultados em JSON, CSV, Excel, XML e outros formatos da Apify.
- ⚡ Funciona em lote pelo modo Batch e em tempo real pelo endpoint Standby.
- 🔒 Protege CPF e nome de pessoa física; mantém nome empresarial e CNPJ de pessoa jurídica completos.

### Quais dados de empresas o Actor retorna?

Cada linha representa um estabelecimento encontrado. Entre os campos disponíveis estão:

| Grupo | Campos principais |
|---|---|
| Identificação | `cnpj`, `cnpjFormatado`, `razaoSocial`, `nomeFantasia`, `matriz` |
| Situação | `situacaoCadastral`, `situacaoCadastralDescricao`, datas e idade da empresa |
| Empresa | natureza jurídica, porte e capital social |
| Localização | logradouro, número oculto, bairro, município, UF, CEP e endereço protegido |
| Contato | `telefone1`, `telefone2`, `email`, além das listas completas `telefones` e `emails` |
| Sócios | nome protegido da pessoa física ou nome completo da pessoa jurídica, tipo, qualificação, data de entrada, faixa etária e documento |
| Atividade | `cnaePrincipal` e `cnaesSecundarios`, apresentados após os sócios |
| Métricas | total de sócios, total de CNAEs secundários e tempos calculados |

Telefone, e-mail, nome fantasia e outros campos podem ser `null` quando não estiverem disponíveis no cadastro consultado.

### Como gerar uma lista de leads por CNAE

1. Encontre uma subclasse de 7 dígitos na [lista de CNAEs do BrasilDados](https://brasildados.org/lista-cnaes/).
2. Informe o código no campo `cnaes`, por exemplo `6201501`.
3. Se quiser, selecione `uf`, `porte` e `situacaoCadastral`.
4. Defina `maximoResultados` para controlar o tamanho e o custo da lista.
5. Inicie o Actor e abra o Dataset para visualizar ou exportar as empresas.

#### Exemplo de input

```json
{
  "cnaes": ["6201501", "6204-0/00"],
  "uf": "SP",
  "situacaoCadastral": "02",
  "maximoResultados": 100
}
```

O campo `cnaes` aceita o código sem máscara (`6201501`) ou no formato IBGE (`6201-5/01`). Para pesquisar todas as situações cadastrais, selecione `todas`.

### Exemplo de resultado JSON

```json
{
  "empresaId": "6f731b62-5036-4c75-9f8e-604547900169",
  "cnpj": "06045479000169",
  "cnpjFormatado": "06.045.479/0001-69",
  "matriz": true,
  "razaoSocial": "EMPRESA DE TECNOLOGIA LTDA",
  "nomeFantasia": "Empresa Exemplo",
  "naturezaJuridica": "2062",
  "naturezaJuridicaDescricao": "Sociedade Empresária Limitada",
  "capitalSocial": "100000.00",
  "capitalSocialNumerico": 100000,
  "porte": "03",
  "porteDescricao": "Empresa de Pequeno Porte",
  "enteFederativo": null,
  "situacaoCadastral": "02",
  "situacaoCadastralDescricao": "Ativa",
  "dataSituacaoCadastral": "2020-03-10",
  "dataInicioAtividade": "2015-04-20",
  "logradouro": "Rua Exemplo",
  "numero": "***",
  "complemento": "Sala 101",
  "bairro": "Centro",
  "cep": "01001000",
  "uf": "SP",
  "municipioCodigo": "3550308",
  "municipioNome": "São Paulo",
  "pais": "1058",
  "paisDescricao": "Brasil",
  "telefone1": "1130000000",
  "telefone2": "11999990000",
  "email": "contato@empresa.com.br",
  "telefones": [
    {
      "tipo": "LANDLINE",
      "ddd": "11",
      "numero": "30000000",
      "telefoneCompleto": "1130000000"
    },
    {
      "tipo": "MOBILE",
      "ddd": "11",
      "numero": "999990000",
      "telefoneCompleto": "11999990000"
    }
  ],
  "emails": [
    {
      "titularidade": "OWN",
      "endereco": "contato@empresa.com.br",
      "dominio": "empresa.com.br"
    }
  ],
  "enderecoCompleto": "Rua Exemplo, ***, Sala 101, Centro, São Paulo - SP, 01001000",
  "idadeEmpresaAnos": 11,
  "idadeEmpresaDias": 4132,
  "tempoSituacaoAtualDias": 2346,
  "totalSocios": 2,
  "totalCnaesSecundarios": 2,
  "tempoMedioSociosDias": 2800,
  "socios": [
    {
      "nome": "Bruno ******",
      "tipo": "1",
      "tipoDescricao": "Pessoa Física",
      "documento": "*****1234**",
      "qualificacao": "49",
      "qualificacaoDescricao": "Sócio-Administrador",
      "dataEntrada": "2018-08-15",
      "faixaEtariaDescricao": "41 a 50 anos"
    },
    {
      "nome": "EMPRESA INVESTIMENTOS LTDA",
      "tipo": "2",
      "tipoDescricao": "Pessoa Jurídica",
      "documento": "11222333000181",
      "qualificacao": "22",
      "qualificacaoDescricao": "Sócio",
      "dataEntrada": "2020-01-10",
      "faixaEtariaDescricao": null
    }
  ],
  "cnaePrincipal": {
    "codigo": "6201-5/01",
    "descricao": "Desenvolvimento de programas de computador sob encomenda"
  },
  "cnaesSecundarios": [
    {
      "codigo": "6202-3/00",
      "descricao": "Desenvolvimento e licenciamento de programas de computador customizáveis"
    },
    {
      "codigo": "6204-0/00",
      "descricao": "Consultoria em tecnologia da informação"
    }
  ]
}
```

O exemplo usa dados fictícios, mas reproduz integralmente os campos, tipos, formatos, níveis e regras de proteção da saída real do Actor.

### 💳 Como funciona a cobrança?

Este Actor usa **Pay per event (PPE)**. Cada empresa efetivamente entregue gera um evento `result-item`. Buscas vazias, registros descartados e itens que não puderam ser cobrados não são entregues nem cobrados.

Use `maximoResultados` para limitar a quantidade de linhas e estimar o custo antes de iniciar. O preço atualizado de cada resultado aparece na seção **Preço** da página do Actor.

### API Batch e Standby

#### Batch

Use Batch para listas maiores, agendamentos e exportações pelo Dataset:

```bash
curl -X POST "https://api.apify.com/v2/acts/brasildados~gerador-de-leads-scraper-cnae/run-sync-get-dataset-items?token=SEU_TOKEN_APIFY" \
  -H "Content-Type: application/json" \
  -d '{"cnaes":["6201501","6204-0/00"],"uf":"SP","maximoResultados":100}'
```

#### Standby

Use Standby para integrações HTTP em tempo real pelo único endpoint `POST /buscar`:

```bash
curl -X POST "https://brasildados--gerador-de-leads-scraper-cnae.apify.actor/buscar" \
  -H "Authorization: Bearer SEU_TOKEN_APIFY" \
  -H "Content-Type: application/json" \
  --compressed \
  -d '{"cnaes":["6201501","6204-0/00"],"maximoResultados":100}'
```

O Standby aceita corpo JSON de até 5 MB. Respostas inválidas usam `{ "error": "mensagem" }` com status `400`; falhas internas tratadas usam o mesmo formato com status `500`.

### Casos de uso

- geração de leads B2B por segmento;
- prospecção comercial por CNAE e região;
- mapeamento de mercado e concorrentes;
- busca de fornecedores, parceiros e clientes potenciais;
- criação de listas para CRM e análise de mercado;
- segmentação de empresas por porte e situação cadastral.

### 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.
- [Todos os Actors do BrasilDados](https://apify.com/brasildados?fpr=t5lwzq) para outras consultas empresariais no Brasil.

### Perguntas frequentes

#### Onde encontro códigos CNAE?

Use a [lista de CNAEs do BrasilDados](https://brasildados.org/lista-cnaes/) para pesquisar e copiar subclasses oficiais de 7 dígitos.

#### Posso buscar empresas no Brasil inteiro?

Sim. Deixe `uf` vazio para pesquisar em todos os estados.

#### O resultado traz telefone e e-mail?

Sim, quando esses dados estiverem disponíveis no cadastro consultado. A presença varia entre empresas.

#### Os dados pessoais são protegidos?

Sim. Para pessoa física, o Actor retorna somente o primeiro nome e mascara o CPF. Para pessoa jurídica, mantém o nome completo e o CNPJ empresarial sem máscara quando disponíveis. O número do endereço também é ocultado. Use os dados com finalidade legítima e em conformidade com a LGPD.

#### Qual modo devo usar?

Use Batch para volumes maiores e exportações. Use Standby para respostas HTTP imediatas. Consultas que possam levar vários minutos devem ser executadas em Batch.

# Actor input Schema

## `cnaes` (type: `array`):

Uma ou mais subclasses CNAE de 7 dígitos. Aceita 6201501 ou 6201-5/01. Lista completa: https://brasildados.org/lista-cnaes/

## `uf` (type: `string`):

Estado brasileiro para filtrar os resultados. Deixe vazio para pesquisar em todo o Brasil.

## `porte` (type: `array`):

Selecione um ou mais portes. Deixe vazio para incluir todos.

## `situacaoCadastral` (type: `string`):

Situação cadastral desejada. O padrão retorna somente empresas ativas.

## `maximoResultados` (type: `integer`):

Quantidade máxima de empresas retornadas, entre 1 e 5.000. A cobrança PPE ocorre somente para cada linha efetivamente entregue.

## Actor input object example

```json
{
  "cnaes": [
    "6201501",
    "6204-0/00"
  ],
  "uf": "SP",
  "situacaoCadastral": "02",
  "maximoResultados": 100
}
```

# Actor output Schema

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

Dataset com uma linha por estabelecimento encontrado, pronto para exportação em JSON, CSV ou Excel.

# 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 = {
    "cnaes": [
        "6201501",
        "6204-0/00"
    ],
    "uf": "SP",
    "maximoResultados": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("brasildados/gerador-de-leads-scraper-cnae").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 = {
    "cnaes": [
        "6201501",
        "6204-0/00",
    ],
    "uf": "SP",
    "maximoResultados": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("brasildados/gerador-de-leads-scraper-cnae").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 '{
  "cnaes": [
    "6201501",
    "6204-0/00"
  ],
  "uf": "SP",
  "maximoResultados": 100
}' |
apify call brasildados/gerador-de-leads-scraper-cnae --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,brasildados/gerador-de-leads-scraper-cnae"
        }
    }
}

```

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/lu1JpsyThuJBJ5jJS/builds/yqKMnZeB2Nkh3bGrW/openapi.json