# CNPJ Enricher - Brazilian Company Data (`silentflow/cnpj-enricher`) Actor Enrich Brazilian CNPJ numbers with complete company data from 3 official sources. Get legal name, trade name, address, phone, email, CNAE activity codes, tax regime (Simples/MEI), shareholders with roles, entry dates and nationality, plus state tax registrations. Fast bulk processing for B2B leads. - **URL**: https://apify.com/silentflow/cnpj-enricher.md - **Developed by:** [SilentFlow](https://apify.com/silentflow) (community) - **Categories:** Lead generation, Developer tools, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 ## CNPJ Enricher - Brazilian Company Data ### ✨ Why use this scraper? - 🏒 **Complete company profiles** β€” Get the full official registration record for any Brazilian business, including legal name, trade name, incorporation date, and legal nature - πŸ“ **Full address data** β€” Retrieve structured address information including street, district, ZIP code, city, state, and IBGE municipal code - πŸ‘₯ **Shareholder and management data** β€” Access the board of directors and partners list with roles, tenure dates, and age range - 🏭 **CNAE activity classification** β€” Get primary and secondary CNAE codes with full hierarchical breakdown (section, division, group, class) - πŸ’Ό **Tax regime information** β€” Know instantly whether a company is enrolled in Simples Nacional or MEI - πŸ”„ **Bulk enrichment** β€” Process hundreds of CNPJs in a single run and pay only for successful results ### 🎯 Use cases - Enrich a CRM or lead database with official Brazilian company data before outreach - Validate that a supplier or partner company is active and correctly registered - Build a B2B prospecting list with contact emails and phone numbers - Automate KYC/compliance checks by verifying legal status, shareholders, and CNAE activity - Research market segments by aggregating CNAE classification across a list of companies - Cross-reference state registration numbers for tax compliance audits ### πŸ“₯ Input parameters | Field | Type | Required | Description | |-------|------|----------|-------------| | `cnpjs` | array of strings | No | List of CNPJ numbers to look up. Accepts 14-digit raw format (`00000000000191`) or formatted (`00.000.000/0001-91`) | | `maxItems` | integer | No (default: 100) | Maximum number of results to return. Useful to control costs on large batches | | `searchCnae` | string | No | Search companies by CNAE activity code (e.g., `5611201` for restaurants, `6422100` for banks). Found companies are enriched automatically | | `searchState` | string | No | Filter search results by Brazilian state code (e.g., `SP`, `RJ`, `MG`). Used with CNAE search | | `searchCity` | string | No | Filter search results by city name in uppercase (e.g., `SAO PAULO`, `RIO DE JANEIRO`). Used with CNAE search | ### πŸ“Š Output data Each successful lookup returns a JSON object with the company's full official registration record. Results are saved to the Apify dataset as a JSON array β€” one object per CNPJ. If a CNPJ cannot be found or is invalid, the object includes an `error` field describing the issue. ### πŸ—‚οΈ Data fields #### Identity | Field | Type | Description | |-------|------|-------------| | `cnpj` | string | CNPJ in formatted notation (`XX.XXX.XXX/XXXX-XX`) | | `cnpjRaw` | string | CNPJ as 14 raw digits | | `razaoSocial` | string | Official registered legal name | | `nomeFantasia` | string | Trade name / DBA | | `naturezaJuridica` | object | Legal nature with `codigo` and `descricao` | | `capitalSocial` | number | Share capital in BRL | | `porte` | string | Company size classification (e.g. `DEMAIS`, `ME`, `EPP`) | | `tipo` | string | Branch type: `MATRIZ` (headquarters) or `FILIAL` (branch) | #### Activity | Field | Type | Description | |-------|------|-------------| | `cnaePrincipal` | object | Primary CNAE with `codigo`, `descricao`, `secao`, `divisao`, `grupo`, `classe` | | `cnaesSecundarios` | array | Secondary CNAEs, each with the same structure as `cnaePrincipal` | #### Address | Field | Type | Description | |-------|------|-------------| | `endereco.logradouro` | string | Street name and type | | `endereco.numero` | string | Street number | | `endereco.complemento` | string | Address complement | | `endereco.bairro` | string | Neighborhood / district | | `endereco.cep` | string | ZIP code (CEP) | | `endereco.cidade` | string | City name | | `endereco.estado` | string | State abbreviation (UF) | | `endereco.codigoIBGE` | number | IBGE municipal code | | `endereco.pais` | string | Country name | #### Contact | Field | Type | Description | |-------|------|-------------| | `telefone` | string | Primary phone number | | `fax` | string | Fax number | | `email` | string | Official contact email address | #### Status | Field | Type | Description | |-------|------|-------------| | `situacaoCadastral` | string | Registration status (e.g. `ATIVA`, `BAIXADA`, `SUSPENSA`) | | `dataSituacaoCadastral` | string | Date of current status (ISO 8601) | | `motivoSituacaoCadastral` | string | Reason for current status | | `dataInicioAtividade` | string | Date of incorporation / start of activity (ISO 8601) | | `situacaoEspecial` | string | Special status flag, if any | #### Tax regime | Field | Type | Description | |-------|------|-------------| | `simples.optante` | boolean | Whether the company is enrolled in Simples Nacional | | `simples.dataOpcao` | string | Date of Simples Nacional enrollment | | `simples.dataExclusao` | string | Date of Simples Nacional exit, if applicable | | `mei.optante` | boolean | Whether the company is registered as MEI | | `mei.dataOpcao` | string | Date of MEI enrollment | | `mei.dataExclusao` | string | Date of MEI exit, if applicable | #### Shareholders | Field | Type | Description | |-------|------|-------------| | `socios[].nome` | string | Partner or director full name | | `socios[].qualificacao` | string | Role / qualification | | `socios[].dataEntrada` | string | Date joined the company (ISO 8601) | | `socios[].faixaEtaria` | string | Age range (e.g. `41 a 50 anos`) | | `socios[].pais` | string | Country of the partner | #### State registrations | Field | Type | Description | |-------|------|-------------| | `inscricoesEstaduais[].inscricaoEstadual` | string | State registration number | | `inscricoesEstaduais[].ativo` | boolean | Whether the state registration is active | | `inscricoesEstaduais[].estado` | string | State abbreviation (UF) | #### Metadata | Field | Type | Description | |-------|------|-------------| | `scrapedAt` | string | Timestamp of the lookup (ISO 8601) | | `dataSources` | array | List of official databases that contributed data for this record | | `error` | string | Error message if the CNPJ could not be retrieved (field absent on success) | ### πŸš€ Examples #### Example input β€” enrich specific CNPJs ```json { "cnpjs": ["00000000000191", "33.000.167/0001-01"], "maxItems": 10 } ```` #### Example input β€” search by CNAE code ```json { "searchCnae": "5611201", "searchState": "SP", "searchCity": "SAO PAULO", "maxItems": 50 } ``` #### Example output (truncated) ```json { "cnpj": "00.000.000/0001-91", "cnpjRaw": "00000000000191", "razaoSocial": "BANCO DO BRASIL SA", "nomeFantasia": "DIRECAO GERAL", "naturezaJuridica": { "codigo": "2038", "descricao": "Sociedade de Economia Mista" }, "capitalSocial": 120000000000, "porte": "DEMAIS", "tipo": "MATRIZ", "cnaePrincipal": { "codigo": "6422100", "descricao": "Bancos mΓΊltiplos, com carteira comercial", "secao": "K", "divisao": "64", "grupo": "64.2", "classe": "64.22-1" }, "cnaesSecundarios": [ { "codigo": "6499999", "descricao": "Outras atividades de serviΓ§os financeiros nΓ£o especificadas anteriormente", "secao": "K", "divisao": "64", "grupo": "64.9", "classe": "64.99-9" } ], "endereco": { "logradouro": "SAUN QUADRA 5 BLOCO B TORRE I, II, III", "numero": "SN", "complemento": "ANDAR T I SL S101 A S1602 T II SL C101 A C1602 TIII SL N101 A N1602", "bairro": "ASA NORTE", "cep": "70040912", "cidade": "BRASILIA", "estado": "DF", "codigoIBGE": 5300108, "pais": "Brasil" }, "telefone": "6134939002", "fax": "6134931040", "email": "secex@bb.com.br", "situacaoCadastral": "ATIVA", "dataSituacaoCadastral": "2005-11-03", "motivoSituacaoCadastral": "SEM MOTIVO", "dataInicioAtividade": "1966-08-01", "simples": { "optante": false, "dataOpcao": "2007-07-01", "dataExclusao": "2007-07-01" }, "mei": { "optante": false, "dataOpcao": "2009-07-01", "dataExclusao": "2009-07-01" }, "socios": [ { "nome": "TARCIANA PAULA GOMES MEDEIROS", "qualificacao": "Presidente", "dataEntrada": "2023-01-26", "faixaEtaria": "41 a 50 anos", "pais": "Brasil" } ], "inscricoesEstaduais": [ { "inscricaoEstadual": "0809427800174", "ativo": true, "estado": "DF" } ], "scrapedAt": "2026-04-08T14:55:18Z", "dataSources": ["brasilapi", "receitaws", "cnpjws"] } ``` ### πŸ’» Integrations #### Python ```python from apify_client import ApifyClient client = ApifyClient("YOUR_API_TOKEN") run = client.actor("silentflow/cnpj-enricher").call(run_input={ "cnpjs": ["00000000000191"] }) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item["razaoSocial"], item["email"]) ``` #### JavaScript ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_API_TOKEN' }); const run = await client.actor('silentflow/cnpj-enricher').call({ cnpjs: ['00000000000191'] }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach(item => console.log(item.razaoSocial, item.email)); ``` ### πŸ“ˆ Performance & limits - Processes hundreds of CNPJs per run - Data sourced from 3 official Brazilian databases for maximum completeness - Pay only for successful results ### πŸ’‘ Tips for best results - Use raw 14-digit CNPJs (e.g. `00000000000191`) for fastest processing - Formatted CNPJs (e.g. `00.000.000/0001-91`) are also accepted and automatically normalized - Use `maxItems` to control costs when processing large batches - Branch CNPJs (filiais) return their own separate registration record β€” query each CNPJ individually ### ❓ FAQ **What data sources are used?** Data is retrieved from 3 official Brazilian government databases and merged into a single enriched record per CNPJ. **Can I submit formatted CNPJs?** Yes. Both raw 14-digit format (`00000000000191`) and the standard formatted notation (`00.000.000/0001-91`) are accepted. The actor normalizes them automatically. **What happens if a CNPJ is invalid or not found?** The result object will include an `error` field describing the issue (e.g. invalid format, company not found). You are not charged for failed lookups. **Is historical data available?** No. The actor returns current official registration data only. Information reflects the most recent state in the Brazilian federal registry. ### πŸ“¬ Support For questions or feature requests, contact us through the Apify platform. # Actor input Schema ## `cnpjs` (type: `array`): List of Brazilian CNPJ numbers to enrich (14 digits, with or without formatting) ## `maxItems` (type: `integer`): Maximum number of results to return ## `searchCnae` (type: `string`): Search companies by CNAE activity code (e.g., 5611201 for restaurants, 6422100 for banks). Returns all matching companies for enrichment. ## `searchState` (type: `string`): Filter search results by Brazilian state (e.g., SP, RJ, MG). Used with CNAE search. ## `searchCity` (type: `string`): Filter search results by city name (e.g., SAO PAULO, RIO DE JANEIRO). Used with CNAE search. ## Actor input object example ```json { "cnpjs": [ "00000000000191" ], "maxItems": 100 } ``` # Actor output Schema ## `companies` (type: `string`): Complete company profiles: razaoSocial, cnpj, nomeFantasia, naturezaJuridica, capitalSocial, cnaePrincipal, cnaesSecundarios, endereco, telefone, email, situacaoCadastral, simples/MEI, socios, inscricoesEstaduais. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "cnpjs": [ "00000000000191" ] }; // Run the Actor and wait for it to finish const run = await client.actor("silentflow/cnpj-enricher").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "cnpjs": ["00000000000191"] } # Run the Actor and wait for it to finish run = client.actor("silentflow/cnpj-enricher").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" ] }' | apify call silentflow/cnpj-enricher --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=silentflow/cnpj-enricher", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "CNPJ Enricher - Brazilian Company Data", "description": "Enrich Brazilian CNPJ numbers with complete company data from 3 official sources. Get legal name, trade name, address, phone, email, CNAE activity codes, tax regime (Simples/MEI), shareholders with roles, entry dates and nationality, plus state tax registrations. Fast bulk processing for B2B leads.", "version": "1.0", "x-build-id": "JJR8ZIgs6zFgcgslQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/silentflow~cnpj-enricher/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-silentflow-cnpj-enricher", "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/silentflow~cnpj-enricher/runs": { "post": { "operationId": "runs-sync-silentflow-cnpj-enricher", "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/silentflow~cnpj-enricher/run-sync": { "post": { "operationId": "run-sync-silentflow-cnpj-enricher", "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", "properties": { "cnpjs": { "title": "CNPJ Numbers", "type": "array", "description": "List of Brazilian CNPJ numbers to enrich (14 digits, with or without formatting)", "items": { "type": "string" } }, "maxItems": { "title": "Max results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of results to return", "default": 100 }, "searchCnae": { "title": "Search by CNAE code", "type": "string", "description": "Search companies by CNAE activity code (e.g., 5611201 for restaurants, 6422100 for banks). Returns all matching companies for enrichment." }, "searchState": { "title": "Search state (UF)", "type": "string", "description": "Filter search results by Brazilian state (e.g., SP, RJ, MG). Used with CNAE search." }, "searchCity": { "title": "Search city", "type": "string", "description": "Filter search results by city name (e.g., SAO PAULO, RIO DE JANEIRO). Used with CNAE search." } } }, "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 } } } } } } } } } } ```