# Leads de Energia Solar - Geração Distribuída ANEEL (`brasildados/leads-energia-solar-geracao-distribuida`) Actor

Encontre empresas, indústrias, propriedades rurais e órgãos públicos que já instalaram energia solar (geração distribuída). Dados oficiais da ANEEL: CNPJ, razão social, cidade, potência instalada, distribuidora e data de instalação.

- **URL**: https://apify.com/brasildados/leads-energia-solar-geracao-distribuida.md
- **Developed by:** [BrasilDados.org - Hub de APIs de Dados do Brasil](https://apify.com/brasildados) (community)
- **Categories:** Lead generation, Real estate, AI
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $100.00 / 1,000 por lead encontrados

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/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

### 🔎 O que é o Leads de Energia Solar - Geração Distribuída ANEEL?

Busque **empresas, indústrias, propriedades rurais e órgãos públicos com CNPJ que já instalaram energia solar** no Brasil, direto da base oficial de Geração Distribuída da ANEEL. Informe a UF e receba CNPJ, razão social, cidade, potência instalada, distribuidora e data de atualização cadastral de cada instalação encontrada.

Exporte os resultados em **JSON, CSV ou Excel**, ou conecte o Actor à API da Apify e aos seus próprios fluxos de automação e CRM.

> **Entrada simples:** informe a UF `SP` e escolha quantos leads deseja receber.

### O que este gerador de leads solares faz?

- Consulta a base pública de Geração Distribuída da ANEEL, atualizada periodicamente pela própria agência.
- Filtra automaticamente apenas registros com **CNPJ** — descarta registros de pessoa física, que a ANEEL já entrega mascarados por exigência da LGPD.
- Permite filtrar por UF, município, classe de consumo (Comercial, Industrial, Rural, Poder Público, Serviço Público, Consumo Próprio) e faixa de potência instalada.
- Permite buscar apenas instalações atualizadas a partir de uma data, para monitorar novos leads desde a última execução.
- Retorna razão social, CNPJ formatado, cidade, UF, CEP, distribuidora de energia e modalidade da instalação.
- Roda em **Batch** (execução tradicional com Dataset) e em **Standby** (resposta HTTP em tempo real).
- Exporta os resultados em JSON, CSV e Excel.

### Para que usar estes dados?

#### Geração de leads para instaladoras e integradoras solares

Quem já instalou um sistema fotovoltaico é comprador comprovado do setor. Use a lista para oferecer expansão de potência, manutenção preventiva e upgrade de inversores.

#### Prospecção para seguradoras e fintechs de crédito solar

Sistemas solares instalados precisam de seguro do equipamento e, muitas vezes, de refinanciamento do investimento inicial. A base já vem segmentada por porte (micro ou minigeração) e potência.

#### Inteligência de mercado por região

Cruze UF, município e distribuidora para entender onde a geração distribuída solar está crescendo mais rápido e priorizar praças de atuação.

#### Enriquecimento de base própria

Combine o CNPJ retornado aqui com outros Actors da BrasilDados para completar o perfil da empresa antes de uma abordagem comercial.

### Como usar o Leads de Energia Solar?

1. Informe a **UF** onde deseja buscar.
2. Se quiser, refine por município, classe de consumo ou faixa de potência instalada.
3. Defina o número máximo de resultados em `maxResultados`.
4. Clique em **Start**.
5. Consulte ou exporte o Dataset em JSON, CSV ou Excel.

### Entrada

Somente o campo **UF** é obrigatório — ele mantém a consulta rápida mesmo com a base nacional completa.

| Campo | Obrigatório | Descrição | Exemplo |
|---|---:|---|---|
| `uf` | Sim | Estado onde buscar as instalações solares | `SP` |
| `municipio` | Não | Filtra por nome do município (busca parcial) | `Campinas` |
| `classesConsumo` | Não | Segmento do titular. Padrão: Comercial, Industrial, Rural e Poder Público | `["Comercial", "Industrial"]` |
| `potenciaMinKw` | Não | Potência instalada mínima, em kW | `10` |
| `potenciaMaxKw` | Não | Potência instalada máxima, em kW | `500` |
| `instaladoDesde` | Não | Retorna apenas registros atualizados a partir desta data (AAAA-MM-DD) | `2026-06-01` |
| `maxResultados` | Não | Quantidade máxima de leads retornados (padrão 100, máximo 5000) | `200` |

```json
{
  "uf": "SP",
  "classesConsumo": ["Comercial", "Industrial"],
  "potenciaMinKw": 10,
  "maxResultados": 200
}
```

### 📦 Saída

Cada instalação solar encontrada ocupa uma linha no Dataset.

| Campo | Descrição |
|---|---|
| `uf` | Estado da instalação |
| `municipio` | Município da instalação |
| `cep` | CEP do empreendimento |
| `cnpj` | CNPJ do titular, 14 dígitos sem máscara |
| `cnpjFormatado` | CNPJ formatado (`00.000.000/0000-00`) |
| `razaoSocial` | Titular da instalação |
| `classeConsumo` | Segmento (Comercial, Industrial, Rural, Poder Público, Serviço Público, Consumo Próprio) |
| `subGrupoTarifario` | Subgrupo tarifário da unidade consumidora |
| `porte` | Microgeração ou Minigeração |
| `potenciaInstaladaKw` | Potência instalada, em kW |
| `quantidadeUcRecebeCredito` | Quantidade de unidades consumidoras que recebem crédito da geração |
| `modalidade` | Ex.: geração na própria UC, autoconsumo remoto, geração compartilhada |
| `distribuidora` | Distribuidora de energia responsável pela área |
| `codigoEmpreendimento` | Código do empreendimento na ANEEL |
| `dataAtualizacaoCadastral` | Data de atualização cadastral, formato `DD/MM/AAAA` |
| `consultadoEm` | Data e hora da consulta (ISO 8601) |

```json
{
  "uf": "MG",
  "municipio": "São João Evangelista",
  "cep": "39705000",
  "cnpj": "09265094000103",
  "cnpjFormatado": "09.265.094/0001-03",
  "razaoSocial": "POSTO DM LTDA",
  "classeConsumo": "Comercial",
  "subGrupoTarifario": "B3",
  "porte": "Microgeracao",
  "potenciaInstaladaKw": 13,
  "quantidadeUcRecebeCredito": 1,
  "modalidade": "Geração na própria UC",
  "distribuidora": "CEMIG DISTRIBUICAO S.A",
  "codigoEmpreendimento": "GD.MG.001234",
  "dataAtualizacaoCadastral": "30/06/2026",
  "consultadoEm": "2026-08-22T12:00:00.000Z"
}
```

Exporte o Dataset em JSON, CSV, Excel, HTML, XML ou RSS diretamente pela interface da Apify.

### Quanto custa usar o gerador de leads solares?

O Actor usa o modelo **Pay per event**: você paga apenas pelo evento `lead-solar-encontrado`, cobrado uma única vez para cada lead efetivamente entregue no Dataset. Buscas sem resultado não geram cobrança.

Como referência de agosto de 2026, cada lead entregue custa uma fração de dólar — o valor exato e sempre atualizado fica na aba **Pricing** da página do Actor. Uma busca com `maxResultados: 200` que retorne, por exemplo, 80 instalações cobra por 80 eventos, não pelos 200 solicitados.

### Usar pela API da Apify

```bash
curl -X POST \
  "https://api.apify.com/v2/acts/brasildados~leads-energia-solar-geracao-distribuida/run-sync-get-dataset-items?token=SEU_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"uf":"SP","classesConsumo":["Comercial","Industrial"],"potenciaMinKw":10,"maxResultados":100}'
```

Veja também as abas **API** e **Integrations** do Actor para gerar o código em outras linguagens e conectar com Zapier, Make e n8n.

### 🚀 Executar em Batch ou Standby

Use **Batch** para volumes maiores, agendamentos e exportação pelo Dataset. Use **Standby** para receber a lista de leads diretamente na resposta HTTP, sem esperar o ciclo completo de uma execução.

#### Batch

```bash
curl -X POST \
  "https://api.apify.com/v2/acts/brasildados~leads-energia-solar-geracao-distribuida/runs?token=SEU_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"uf":"SP","classesConsumo":["Comercial","Industrial"],"potenciaMinKw":10,"maxResultados":100}'
```

#### Standby

```bash
curl -X POST \
  "https://brasildados--leads-energia-solar-geracao-distribuida.apify.actor/leads-solar" \
  -H "Authorization: Bearer SEU_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"uf":"SP","classesConsumo":["Comercial","Industrial"],"potenciaMinKw":10,"maxResultados":100}'
```

### ⚠️ Limitações

- A base depende da atualização periódica feita pela própria ANEEL; instalações muito recentes podem ainda não constar.
- Apenas registros com CNPJ são retornados; instalações de pessoa física (CPF) são descartadas porque a ANEEL já as entrega mascaradas por LGPD.
- Campos como `subGrupoTarifario`, `quantidadeUcRecebeCredito` e `modalidade` podem vir `null` quando a distribuidora não informou o dado à ANEEL.
- O limite de resultados por execução é de 5000 leads (`maxResultados`).
- Se nenhum registro atender aos filtros informados, o Dataset é retornado vazio, sem cobrança.
- O modo Standby aceita apenas requisições `POST` na rota `/leads-solar`.

### ❓ Perguntas frequentes

#### Como encontrar empresas que já instalaram energia solar no Brasil?

Informe a UF desejada neste Actor e, opcionalmente, um município, classe de consumo ou potência mínima. O resultado traz CNPJ, razão social e dados da instalação de cada empresa encontrada.

#### Os dados incluem pessoa física (CPF)?

Não. A própria ANEEL mascara os registros de pessoa física por exigência da LGPD, e o Actor já filtra esses casos automaticamente, retornando apenas titulares com CNPJ.

#### Posso exportar os resultados para Excel?

Sim. O Dataset pode ser exportado em JSON, CSV, Excel, HTML, XML ou RSS pela própria interface da Apify.

#### Preciso de uma chave da API da ANEEL para usar este Actor?

Não. A consulta à base oficial já está embutida no Actor — basta informar os filtros de busca.

#### É permitido coletar estes dados?

Sim. Os dados vêm do Portal de Dados Abertos da ANEEL, publicados sob licença de dados abertos do governo federal.

### Suporte

Encontrou um problema? Use a aba **Issues** do Actor e envie o ID da execução, o input utilizado (sem credenciais) e uma descrição do resultado esperado.

### Outros Actors da BrasilDados

| Actor | Para que serve |
|---|---|
| [Gerador de Leads por CNAE](https://apify.com/brasildados/gerador-de-leads-scraper-cnae?fpr=t5lwzq) | Busca empresas com CNPJ por segmento de atuação (CNAE) |
| [CNPJ Lead Scraper - Search by CNAE](https://apify.com/brasildados/cnpj-lead-scraper-search?fpr=t5lwzq) | Encontra empresas por segmento para prospecção B2B |
| [Consulta CNPJ em Lote - Enriquecimento de Empresas](https://apify.com/brasildados/enriquecimento-lista-empresas-por-cnpj?fpr=t5lwzq) | Enriquece uma lista própria de CNPJs com dados cadastrais |

Veja todos os Actors da BrasilDados em [apify.com/brasildados](https://apify.com/brasildados?fpr=t5lwzq).

# Actor input Schema

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

Estado onde buscar as instalações solares. Campo obrigatório para manter a consulta rápida.

## `municipio` (type: `string`):

Opcional. Filtra por nome do município (busca parcial). Deixe vazio para todo o estado.

## `classesConsumo` (type: `array`):

Opcional. Segmento do titular da instalação. Padrão: Comercial, Industrial, Rural e Poder Público (os segmentos com maior valor como lead B2B).

## `potenciaMinKw` (type: `integer`):

Opcional. Retorna apenas instalações com potência maior ou igual a este valor.

## `potenciaMaxKw` (type: `integer`):

Opcional. Retorna apenas instalações com potência menor ou igual a este valor.

## `instaladoDesde` (type: `string`):

Opcional. Retorna apenas registros atualizados a partir desta data (AAAA-MM-DD). Útil para monitorar instalações novas.

## `maxResultados` (type: `integer`):

Quantidade máxima de leads retornados nesta execução.

## Actor input object example

```json
{
  "uf": "SP",
  "municipio": "Campinas",
  "classesConsumo": [
    "Comercial",
    "Industrial",
    "Rural",
    "Poder Público"
  ],
  "instaladoDesde": "2026-06-01",
  "maxResultados": 100
}
```

# Actor output Schema

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

Dataset com uma linha por instalação solar. Exporte para CSV, Excel ou JSON para importar no seu CRM.

# 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 = {
    "uf": "SP",
    "classesConsumo": [
        "Comercial",
        "Industrial",
        "Rural",
        "Poder Público"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("brasildados/leads-energia-solar-geracao-distribuida").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 = {
    "uf": "SP",
    "classesConsumo": [
        "Comercial",
        "Industrial",
        "Rural",
        "Poder Público",
    ],
}

# Run the Actor and wait for it to finish
run = client.actor("brasildados/leads-energia-solar-geracao-distribuida").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 '{
  "uf": "SP",
  "classesConsumo": [
    "Comercial",
    "Industrial",
    "Rural",
    "Poder Público"
  ]
}' |
apify call brasildados/leads-energia-solar-geracao-distribuida --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,brasildados/leads-energia-solar-geracao-distribuida"
        }
    }
}

```

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/j5g5AclPz4WP6Z8BU/builds/69cAnUSY8UTJE5HBf/openapi.json