# Brazil Enrichment Data Leads by CNPJ (`brasildados/brazil-enrich-data-lead-by-cnpj`) Actor

Enrich any Brazilian CNPJ with official registry data: company name, address, shareholders (QSA), phone, email, CNAE and more. Returns 50+ fields per company. Pay only per result. | Enriqueça CNPJs com dados cadastrais oficiais: razão social, endereço, sócios, telefone, email e CNAE.

- **URL**: https://apify.com/brasildados/brazil-enrich-data-lead-by-cnpj.md
- **Developed by:** [BrasilDados.org](https://apify.com/brasildados) (community)
- **Categories:** Lead generation, AI, Automation
- **Stats:** 13 total users, 4 monthly users, 99.4% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 per cnpj success results

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 a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use 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

#### 🏢 What is CNPJ Enrichment?

**CNPJ Enrichment** turns a list of Brazilian company tax IDs into complete business profiles from the official **Receita Federal CNPJ registry**, each with a proprietary **score index** (`scoreCadastral`, 0–100) for lead prioritization. Paste up to **1,000 CNPJs** per run (with or without mask), export to **JSON, CSV or Excel**, or call the **REST API** in real time.

> **One CNPJ in = one enriched record out.** Get razão social, trade name, address, phone, email, CNAE activity codes, shareholders (QSA) and **score index** in a single step. Enable **`incluirDadosPortais`** for Simples, MEI, state IE and Suframa as JSON (no PDF). Invalid check digits are skipped locally and are **not charged**.

**Already have CNPJs?** Use this actor. **Need to discover companies by industry?** Use [CNPJ Lead Scraper by CNAE](https://apify.com/brasildados/cnpj-lead-scraper-search?fpr=t5lwzq) instead.

##### What data can CNPJ Enrichment extract?

| | |
|---|---|
| 🏷️ **Identity** | `razaoSocial`, `nomeFantasia`, `cnpj`, `cnpjFormatado`, `matriz` |
| ✅ **Status** | `situacaoCadastralDescricao`, opening/closing dates, company age |
| 📊 **Activity** | `cnaePrincipal`, `cnaesSecundarios` (IBGE codes + descriptions) |
| 📈 **Score index** | `scoreCadastral` (0–100 proprietary index for lead prioritization; not a credit rating) |
| 📍 **Address** | Street, number, district, city, UF, ZIP, `enderecoCompleto` |
| ☎️ **Contact** | `telefone1`, `telefone2`, `email` (when declared in the registry) |
| 👥 **Corporate** | `capitalSocial`, `porteDescricao`, `naturezaJuridicaDescricao` |
| 🤝 **QSA** | `socios[]` with name, role, masked tax ID, entry date |
| 🏛️ **Portals** *(optional)* | `simples`, `simei`, `inscricoesEstaduais[]`, `suframa[]` when `incluirDadosPortais: true` |
| 🕐 **Metadata** | `consultadoEm`, derived fields (`idadeEmpresaAnos`, etc.) |

##### What can this Actor do?

- 📋 **Bulk enrichment:** up to 1,000 CNPJs per run from CRM exports or spreadsheets
- 📈 **Score index:** `scoreCadastral` on every record to rank and filter leads
- 🏛️ **Portal data (optional):** Simples, MEI, IE and Suframa JSON via `incluirDadosPortais`
- 🔢 **Flexible input:** `33.000.167/0001-01`, `33000167000101` or mixed in the same request
- 📤 **Multiple exports:** JSON, CSV, Excel, XML from the Apify Dataset tab
- ⚡ **Standby REST API:** `POST /enrich` for real-time integration (no batch wait)
- 🔗 **Pipeline-ready:** pair with Lead Scraper, KYC or Lawsuits actors from the same store
- 🛡️ **Local validation:** invalid CNPJs are filtered before any upstream call

**Apify platform bonus:** schedule daily refreshes, monitor runs, webhooks, API access and MCP integration on top of the actor itself.

---

### Why enrich Brazilian companies by CNPJ?

- **CRM enrichment:** fill HubSpot, Salesforce or Pipedrive from a CNPJ column
- **Lead qualification:** confirm active status, company size, QSA and **score index** before outreach
- **Pre-KYC / due diligence:** official snapshot before compliance checks
- **Data cleaning:** validate address, phone and email against the federal registry
- **API alternative:** structured CNPJ data without building your own Receita Federal pipeline

Official public data under **Lei 12.527/2011** (Brazilian Access to Information Act). Registry covers **55+ million establishments**, updated monthly.

---

### How do I enrich CNPJ data in bulk?

1. Open the actor on [Apify Console](https://console.apify.com/) and go to the **Input** tab.
2. Paste CNPJs in the **`cnpjs` string list** (one per line or comma-separated).
3. Click **Start** and wait for the run to finish.
4. Open **Dataset** > **Export** > choose **XLSX**, CSV or JSON.

**Example input:**

```json
{
  "cnpjs": ["33.000.167/0001-01", "60701190000104", "00000000000191"],
  "incluirDadosPortais": false
}
````

Set `"incluirDadosPortais": true` to add Simples, MEI, state registrations (IE) and Suframa JSON per CNPJ ($0.03/CNPJ total).

> **Tip:** branches are not expanded automatically. Send each branch CNPJ if you need branch-level data.

***

#### ⬇️ Input

Click the **Input** tab on Apify Console for the full schema. Main field:

| Field | Required | Description |
|---|---|---|
| `cnpjs` | ✅ Yes | String list, max **1,000** CNPJs. Any format. Invalid check digits skipped (not billed). |
| `incluirDadosPortais` | No | Default `false`. When `true`, adds Simples, MEI, IE and Suframa JSON (no PDF). Billed at **$0.03/CNPJ** total. |

***

#### ⬆️ Output

Download results from the **Dataset** tab in JSON, CSV, Excel or XML. One record per valid CNPJ.

> **Abbreviated sample only.** Each record has **39 top-level fields** and **50+ fields total** (including nested QSA). The JSON below shows the most common fields; `"..."` means more data is returned.

**Also returned (not shown in sample):** `scoreCadastral`, `naturezaJuridicaDescricao`, `capitalSocial`, `capitalSocialNumerico`, `porteDescricao`, `dataInicioAtividade`, `cnaesSecundarios[]`, full address (`logradouro`, `cep`, `enderecoCompleto`, ...), `telefone2`, derived metrics (`idadeEmpresaAnos`, `totalSocios`, `tempoMedioSociosDias`, ...), full `socios[]`, and with `incluirDadosPortais`: `simples`, `simei`, `inscricoesEstaduais[]`, `suframa[]`.

```json
[
  {
    "cnpj": "33000167000101",
    "cnpjFormatado": "33.000.167/0001-01",
    "matriz": true,
    "scoreCadastral": 92,
    "razaoSocial": "PETROLEO BRASILEIRO S A PETROBRAS",
    "nomeFantasia": "PETROBRAS",
    "situacaoCadastralDescricao": "Ativa",
    "cnaePrincipal": { "codigo": "0600-0/01", "descricao": "..." },
    "uf": "RJ",
    "municipioNome": "Rio de Janeiro",
    "telefone1": "...",
    "email": "...",
    "socios": [
      {
        "nome": "...",
        "qualificacaoDescricao": "Diretor",
        "documento": "***123456**"
      }
    ],
    "consultadoEm": "2026-06-01T00:00:00.000Z"
  }
]
```

**Complete field list:** **Dataset schema** tab on Apify Console (all fields, types and descriptions).

***

### How much does CNPJ enrichment cost?

**$0.01 per valid CNPJ** (`cnpj-enriched`), including score index. With **`incluirDadosPortais: true`**, **$0.03 per CNPJ** total (base + portal JSON).

| Volume | Base | With portals |
|---|---|---|
| 10 CNPJs | $0.10 | $0.30 |
| 100 CNPJs | $1.00 | $3.00 |
| 1,000 CNPJs | $10.00 | $30.00 |

Free Apify plan users can test with small batches before scaling.

***

#### 🔌 API integration

**Batch run (Console or REST):**

```bash
curl -X POST "https://api.apify.com/v2/acts/brasildados~brazil-enrich-data-lead-by-cnpj/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"cnpjs":["33.000.167/0001-01","60701190000104"]}'
```

**Standby (real-time `POST /enrich`):**

```bash
curl -X POST "https://brasildados--brazil-enrich-data-lead-by-cnpj.apify.actor/enrich" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  --compressed \
  -d '{"cnpjs":["33.000.167/0001-01","60701190000104"],"incluirDadosPortais":true}'
```

Returns a JSON array with one object per valid CNPJ.

***

### Related Actors

| Actor | When to use |
|---|---|
| [CNPJ Lead Scraper by CNAE](https://apify.com/brasildados/cnpj-lead-scraper-search?fpr=t5lwzq) | Find companies by industry code (no CNPJ list yet) |
| [CNPJ KYC & PEP Checker](https://apify.com/brasildados/cnpj-kyc-compliance-pep-checker?fpr=t5lwzq) | PEP, sanctions and electoral donations |
| [CNPJ Lawsuits Check](https://apify.com/brasildados/cnpj-lawsuits-check?fpr=t5lwzq) | Litigation history (5 years, defendant side) |

**Suggested pipeline:** Lead Scraper (CNAE) → **Enrichment (this actor)** → Lawsuits + KYC

***

### FAQ

#### What is `scoreCadastral`?

The **score index** (field `scoreCadastral`): a proprietary **0–100** value on every record to help rank leads. It is **not** a credit score, compliance verdict or legal opinion.

#### Does `incluirDadosPortais` include PDF certificates?

No. It returns **structured JSON** only: Simples, MEI, state IE (CCC) and Suframa. PDFs are not included.

#### How do I enrich a list of CNPJs in Excel?

Paste CNPJs into the `cnpjs` input field, run the actor, then export the Dataset as **XLSX**.

#### What CNPJ formats are accepted?

`XX.XXX.XXX/XXXX-XX`, `XXXXXXXXXXXXXX` or mixed. Check digits are validated locally.

#### Do I get branches automatically?

No. One record per CNPJ sent. Add branch CNPJs to your input if needed.

#### Are phone and email always present?

No. They are optional in the registry. Coverage varies by sector (often 40-70%).

#### How recent is the data?

Monthly refresh from the official registry. Typical lag: 30-45 days for very recent changes.

#### Is it legal to use Receita Federal CNPJ data?

Yes. CNPJ registry data is public under Lei 12.527/2011. Use personal data (QSA, contacts) only with a legitimate business purpose and in compliance with LGPD/GDPR.

***

### 🇧🇷 Versão em português (Brasil)

#### 🏢 O que é o Enriquecimento de CNPJ?

**Enriquecimento de CNPJ** transforma uma lista de CNPJs em cadastros completos da **Receita Federal**, cada um com **`scoreCadastral` (0–100)** proprietário para priorização de leads. Cole até **1.000 CNPJs** por execução (com ou sem máscara), exporte em **JSON, CSV ou Excel**, ou integre via **API REST** em tempo real.

> **1 CNPJ na entrada = 1 registro enriquecido na saída.** Razão social, nome fantasia, endereço, telefone, e-mail, CNAEs, QSA e score cadastral em um passo. Ative **`incluirDadosPortais`** para Simples, MEI, IE e Suframa em JSON (sem PDF). Dígitos inválidos são ignorados localmente e **não são cobrados**.

**Já tem CNPJs?** Use este actor. **Precisa descobrir empresas por setor?** Use o [Lead Scraper por CNAE](https://apify.com/brasildados/cnpj-lead-scraper-search?fpr=t5lwzq).

##### Quais dados o enriquecimento de CNPJ retorna?

| | |
|---|---|
| 🏷️ **Identificação** | `razaoSocial`, `nomeFantasia`, `cnpj`, `cnpjFormatado`, `matriz` |
| ✅ **Situação** | `situacaoCadastralDescricao`, datas de abertura/encerramento, idade |
| 📊 **Atividade** | `cnaePrincipal`, `cnaesSecundarios` (códigos IBGE + descrições) |
| 📈 **Score** | `scoreCadastral` (0–100, índice para priorização; não é rating de crédito) |
| 📍 **Endereço** | Logradouro, número, bairro, cidade, UF, CEP, `enderecoCompleto` |
| ☎️ **Contato** | `telefone1`, `telefone2`, `email` (quando declarados) |
| 👥 **Societário** | `capitalSocial`, `porteDescricao`, `naturezaJuridicaDescricao` |
| 🤝 **QSA** | `socios[]` com nome, qualificação, documento mascarado, entrada |
| 🏛️ **Portais** *(opcional)* | `simples`, `simei`, `inscricoesEstaduais[]`, `suframa[]` com `incluirDadosPortais: true` |
| 🕐 **Metadados** | `consultadoEm`, campos derivados (`idadeEmpresaAnos`, etc.) |

##### O que este Actor faz?

- 📋 **Enriquecimento em lote:** até 1.000 CNPJs por execução
- 📈 **Score cadastral:** `scoreCadastral` em todo registro para ranquear leads
- 🏛️ **Dados de portais (opcional):** Simples, MEI, IE e Suframa via `incluirDadosPortais`
- 🔢 **Entrada flexível:** `33.000.167/0001-01`, `33000167000101` ou misto
- 📤 **Exportação múltipla:** JSON, CSV, Excel, XML no Dataset Apify
- ⚡ **API REST Standby:** `POST /enrich` em tempo real
- 🔗 **Pipeline:** combine com Lead Scraper, KYC ou Processos
- 🛡️ **Validação local:** CNPJs inválidos filtrados antes da consulta

**Bônus Apify:** agende atualizações, monitore execuções, webhooks, API e MCP.

***

### Por que enriquecer empresas brasileiras por CNPJ?

- **Enriquecimento de CRM:** preencha HubSpot, Salesforce ou Pipedrive a partir de CNPJs
- **Qualificação de leads:** confirme situação, porte, QSA e **score cadastral** antes do contato
- **Pré-KYC / due diligence:** snapshot oficial antes de compliance
- **Limpeza de dados:** valide endereço, telefone e e-mail contra o cadastro federal
- **Alternativa a API:** dados estruturados sem montar pipeline próprio da Receita

Dados públicos oficiais sob **Lei 12.527/2011**. Cadastro com **55+ milhões de estabelecimentos**, atualizado mensalmente.

***

### Como enriquecer CNPJs em lote?

1. Abra o actor no [Console Apify](https://console.apify.com/) > aba **Input**.
2. Cole os CNPJs na **lista de strings `cnpjs`** (um por linha ou separados por vírgula).
3. Clique em **Start** e aguarde.
4. **Dataset** > **Export** > **XLSX**, CSV ou JSON.

> **Dica:** filiais não são expandidas automaticamente. Envie o CNPJ de cada filial se precisar.

***

#### ⬇️ Entrada

Clique na aba **Input** para o schema completo.

| Campo | Obrigatório | Descrição |
|---|---|---|
| `cnpjs` | ✅ Sim | Lista de strings, máx. **1.000** CNPJs. Qualquer formato. Inválidos não são cobrados. |
| `incluirDadosPortais` | Não | Padrão `false`. Se `true`, inclui Simples, MEI, IE e Suframa (JSON, sem PDF). **$0,03/CNPJ** no total. |

***

#### ⬆️ Saída

Baixe na aba **Dataset**. Um registro por CNPJ válido.

> **Amostra resumida.** Cada registro tem **39 campos de topo** e **50+ no total** (incluindo QSA). Veja **Dataset schema** para a lista completa.

***

### Quanto custa enriquecer CNPJ?

**$0,01 por CNPJ válido** (`cnpj-enriched`), com score incluído. Com **`incluirDadosPortais: true`**, **$0,03 por CNPJ** no total (base + portais JSON).

| Volume | Base | Com portais |
|---|---|---|
| 10 CNPJs | $0,10 | $0,30 |
| 100 CNPJs | $1,00 | $3,00 |
| 1.000 CNPJs | $10,00 | $30,00 |

***

#### 🔌 Integração via API

Mesmos endpoints da seção em inglês acima. Substitua o token Apify.

***

### Actors relacionados

| Actor | Quando usar |
|---|---|
| [Lead Scraper CNAE](https://apify.com/brasildados/cnpj-lead-scraper-search?fpr=t5lwzq) | Encontrar empresas por CNAE (sem lista de CNPJs) |
| [KYC & PEP Checker](https://apify.com/brasildados/cnpj-kyc-compliance-pep-checker?fpr=t5lwzq) | PEP, sanções e doações eleitorais |
| [Consulta Processos](https://apify.com/brasildados/cnpj-lawsuits-check?fpr=t5lwzq) | Histórico processual (5 anos, polo réu) |

**Pipeline sugerido:** Lead Scraper (CNAE) → **Enriquecimento (este)** → Processos + KYC

***

### Perguntas frequentes

#### O que é `scoreCadastral`?

**Índice 0–100** proprietário em todo registro para priorizar leads. **Não** é score de crédito, parecer de compliance ou opinião jurídica.

#### `incluirDadosPortais` inclui PDF de comprovantes?

Não. Retorna só **JSON estruturado**: Simples, MEI, IE (CCC) e Suframa.

#### Como enriquecer uma lista de CNPJs no Excel?

Cole os CNPJs em `cnpjs`, execute o actor e exporte o Dataset em **XLSX**.

#### Quais formatos de CNPJ são aceitos?

`XX.XXX.XXX/XXXX-XX`, `XXXXXXXXXXXXXX` ou misto. Dígitos verificadores validados localmente.

#### Recebo filiais automaticamente?

Não. Um registro por CNPJ enviado. Inclua CNPJs de filiais na entrada se necessário.

#### Telefone e e-mail sempre vêm?

Não. São opcionais no cadastro. Cobertura varia (geralmente 40-70%).

#### Quão recentes são os dados?

Atualização mensal. Defasagem típica de 30-45 dias para mudanças recentes.

#### É legal usar dados da Receita Federal?

Sim. Cadastro CNPJ é público sob Lei 12.527/2011. Use dados pessoais (QSA, contatos) com finalidade legítima e em conformidade com LGPD/GDPR.

#### O JSON de exemplo mostra tudo?

Não. É amostra resumida. Cada registro tem **39 campos de topo** e **50+ no total**. Lista completa na aba **Dataset schema**.

# Actor input Schema

## `cnpjs` (type: `array`):

List of CNPJs to enrich. Accepts formatted (XX.XXX.XXX/XXXX-XX) or plain digits. Max 1,000 per run. Invalid CNPJs are skipped (not charged). | Lista de CNPJs a enriquecer. Aceita qualquer formato. Máximo 1.000 por execução. Inválidos são ignorados (sem cobrança).

## `incluirDadosPortais` (type: `boolean`):

When enabled, enriches each CNPJ with Simples Nacional, MEI, state tax registrations (IE/CCC) and Suframa as structured JSON. No PDF certificates. Charged at $0.03/CNPJ (includes base + portal). | Quando ativo, inclui Simples, MEI, inscrições estaduais (IE) e Suframa em JSON. Sem PDF. Cobrança $0,03/CNPJ (base + portais).

## Actor input object example

```json
{
  "cnpjs": [
    "00000000000191",
    "33.000.167/0001-01",
    "60701190000104",
    "07.526.557/0001-00"
  ],
  "incluirDadosPortais": false
}
```

# Actor output Schema

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

Dataset with one record per CNPJ establishment, including company data, address, contacts and shareholders (QSA).

# 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 = {
    "cnpjs": [
        "00000000000191",
        "33.000.167/0001-01",
        "60701190000104",
        "07.526.557/0001-00"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("brasildados/brazil-enrich-data-lead-by-cnpj").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 = { "cnpjs": [
        "00000000000191",
        "33.000.167/0001-01",
        "60701190000104",
        "07.526.557/0001-00",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("brasildados/brazil-enrich-data-lead-by-cnpj").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "cnpjs": [
    "00000000000191",
    "33.000.167/0001-01",
    "60701190000104",
    "07.526.557/0001-00"
  ]
}' |
apify call brasildados/brazil-enrich-data-lead-by-cnpj --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=brasildados/brazil-enrich-data-lead-by-cnpj",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Brazil Enrichment Data Leads by CNPJ",
        "description": "Enrich any Brazilian CNPJ with official registry data: company name, address, shareholders (QSA), phone, email, CNAE and more. Returns 50+ fields per company. Pay only per result. | Enriqueça CNPJs com dados cadastrais oficiais: razão social, endereço, sócios, telefone, email e CNAE.",
        "version": "1.1",
        "x-build-id": "Lek8lYNXoOoSKySlO"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/brasildados~brazil-enrich-data-lead-by-cnpj/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-brasildados-brazil-enrich-data-lead-by-cnpj",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/brasildados~brazil-enrich-data-lead-by-cnpj/runs": {
            "post": {
                "operationId": "runs-sync-brasildados-brazil-enrich-data-lead-by-cnpj",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/brasildados~brazil-enrich-data-lead-by-cnpj/run-sync": {
            "post": {
                "operationId": "run-sync-brasildados-brazil-enrich-data-lead-by-cnpj",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "cnpjs"
                ],
                "properties": {
                    "cnpjs": {
                        "title": "CNPJs to enrich / CNPJs para enriquecer",
                        "type": "array",
                        "description": "List of CNPJs to enrich. Accepts formatted (XX.XXX.XXX/XXXX-XX) or plain digits. Max 1,000 per run. Invalid CNPJs are skipped (not charged). | Lista de CNPJs a enriquecer. Aceita qualquer formato. Máximo 1.000 por execução. Inválidos são ignorados (sem cobrança).",
                        "items": {
                            "type": "string"
                        }
                    },
                    "incluirDadosPortais": {
                        "title": "Include portal data (Simples, IE, Suframa) / Incluir dados de portais",
                        "type": "boolean",
                        "description": "When enabled, enriches each CNPJ with Simples Nacional, MEI, state tax registrations (IE/CCC) and Suframa as structured JSON. No PDF certificates. Charged at $0.03/CNPJ (includes base + portal). | Quando ativo, inclui Simples, MEI, inscrições estaduais (IE) e Suframa em JSON. Sem PDF. Cobrança $0,03/CNPJ (base + portais).",
                        "default": false
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```