# Consulta CNPJ em Lote — Brazil Company Data (`paulovitor18/cnpj-bulk-lookup`) Actor Consulte dados completos de empresas brasileiras pelo CNPJ em lote. Razão social, sócios, endereço, CNAE, situação cadastral, regime tributário e score de risco automático. Dados oficiais da Receita Federal via BrasilAPI. - **URL**: https://apify.com/paulovitor18/cnpj-bulk-lookup.md - **Developed by:** [Paulo Vitor Silva da Costa](https://apify.com/paulovitor18) (community) - **Categories:** Developer tools, Lead generation, E-commerce - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 cnpj consultados This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/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 ## Consulta CNPJ em Lote — Brazil Company Data Consulte dados completos de empresas brasileiras diretamente da base da Receita Federal, em lote e com inteligência automática. Ideal para times de vendas B2B, escritórios contábeis, departamentos jurídicos e analistas que precisam enriquecer listas de CNPJs sem trabalho manual. --- ### Por que este Actor é diferente? A maioria dos consultores de CNPJ disponíveis na Apify Store entrega os dados brutos da Receita Federal — exatamente o que você já conseguiria acessando a BrasilAPI diretamente. Este Actor entrega **inteligência processada**: além dos dados cadastrais completos, ele calcula automaticamente o score de risco da empresa, expõe o histórico completo de regime tributário, calcula a idade da empresa em anos e formata todos os campos em linguagem natural, prontos para usar sem pós-processamento. | Funcionalidade | Outros Actors | Este Actor | |---|---|---| | Dados cadastrais básicos | ✅ | ✅ | | CNPJ formatado com máscara | ❌ | ✅ | | Score de risco automático | ❌ | ✅ | | Motivos do risco explicados | ❌ | ✅ | | Regime tributário histórico | ❌ | ✅ | | Idade da empresa calculada | ❌ | ✅ | | Input via CSV | ❌ | ✅ | | Controle de orçamento por run | ❌ | ✅ | --- ### Casos de uso **Times de vendas B2B** usam este Actor para enriquecer listas de leads com dados cadastrais completos antes de iniciar a abordagem comercial. Em vez de pesquisar empresa por empresa no portal da Receita Federal, o time exporta a lista de CNPJs do CRM, cola no campo de input, e recebe um dataset organizado em minutos — com situação cadastral, telefone, e-mail quando disponível, e o score de risco já calculado para priorizar os melhores leads. **Escritórios de contabilidade** utilizam para verificar a situação cadastral e o regime tributário de múltiplos clientes de uma só vez. O histórico de regime tributário — quantos anos a empresa declarou Lucro Real, Simples Nacional ou Isento do IRPJ — é especialmente valioso para análises fiscais e planejamento tributário. **Departamentos jurídicos e de compliance** aplicam o score de risco automático como primeiro filtro em processos de due diligence e KYC (Know Your Customer) antes de fechar contratos com fornecedores ou parceiros. Empresas com situação cadastral irregular, capital social zero ou menos de dois anos de existência são automaticamente sinalizadas com risco MÉDIO ou ALTO. **Analistas de crédito** combinam a situação cadastral, a idade da empresa e o capital social para avaliar o risco de inadimplência em operações B2B. O campo `risco_motivos` explica em linguagem natural por que a empresa recebeu determinada classificação. **Agências e times de marketing B2B** segmentam empresas por CNAE e município para montar listas de prospecção altamente qualificadas, exportando os resultados diretamente para Excel ou integrando via API com ferramentas como Make, Zapier ou n8n. --- ### Como usar #### Cenário 1: Você tem uma lista pequena de CNPJs para testar Cole os CNPJs diretamente no campo **"Lista de CNPJs"** do formulário, um por linha. O Actor aceita CNPJs com ou sem formatação — tanto `33.000.167/0001-01` quanto `33000167000101` funcionam. Use o campo **"Máximo de resultados"** para processar só os primeiros itens e verificar o output antes de rodar a lista completa. #### Cenário 2: Você tem uma planilha com centenas de CNPJs Abra sua planilha no Excel ou Google Sheets e certifique-se de que existe uma coluna com o cabeçalho exato `cnpj` (em minúsculas). Exporte a planilha como CSV. Abra o arquivo CSV em um editor de texto, selecione todo o conteúdo com Ctrl+A, copie, e cole no campo **"Conteúdo CSV"** do formulário. O Actor vai identificar automaticamente a coluna de CNPJs e processar todos os registros. Um CSV de exemplo válido: ```` cnpj,nome\_cliente 33000167000101,Petrobras 00000000000191,Banco do Brasil ```` #### Cenário 3: Você quer integrar via API Use o endpoint padrão da Apify com o seguinte input JSON: ```json { "cnpjs": ["33.000.167/0001-01", "00000000000191"], "maxItems": 100, "delayMs": 600 } ```` Após a execução, os resultados ficam disponíveis no dataset da run e podem ser baixados em JSON, CSV ou Excel diretamente pelo Console da Apify, ou via API usando o `defaultDatasetId` retornado na resposta. *** ### O que você recebe em cada consulta Cada CNPJ consultado gera um item no dataset com os campos organizados em categorias para facilitar o uso direto em planilhas e ferramentas de CRM. **Identificação** traz o CNPJ formatado no padrão visual brasileiro (XX.XXX.XXX/XXXX-XX), o CNPJ numérico puro para joins em planilhas, razão social, nome fantasia, natureza jurídica e porte da empresa. **Situação cadastral** informa o status atual (ATIVA, BAIXADA, SUSPENSA, INAPTA ou NULA), a data da última alteração cadastral e a data de abertura da empresa. **Idade da empresa** é calculada automaticamente em anos inteiros a partir da data de abertura — pronto para usar como filtro em análises sem precisar calcular manualmente. **Score de risco automático** classifica a empresa em BAIXO, MÉDIO ou ALTO com base em três critérios objetivos: situação cadastral (qualquer status diferente de ATIVA eleva o risco), idade da empresa (menos de dois anos indica risco maior) e capital social (zero ou não informado é um sinal de atenção). O campo `risco_motivos` explica em português qual critério foi acionado. **Endereço completo** inclui logradouro, número, complemento, bairro, município, UF e CEP. **Contato** traz telefone e e-mail quando disponíveis na base da Receita Federal — nem todas as empresas têm esses dados registrados. **Regime tributário** expõe o regime declarado no ano mais recente (Lucro Real, Lucro Presumido, Simples Nacional, Isento do IRPJ etc.) e o histórico completo de quantos anos a empresa declarou cada regime. **Atividades** traz o CNAE principal com código e descrição, e a lista completa de CNAEs secundários. **Quadro societário** lista cada sócio com nome, qualificação, data de entrada na sociedade e faixa etária. *** ### Exemplo de output Consulta bem-sucedida (empresa com risco MÉDIO por capital social zero): ```json { "cnpj_consultado": "11.222.333/0001-81", "cnpj_numerico": "11222333000181", "razao_social": "CAIXA ESCOLAR DA ESCOLA ESTADUAL DE ENSINO FUNDAMENTAL JOSEFINA JACQUES NORONHA", "natureza_juridica": "Associação Privada", "porte": "DEMAIS", "situacao_cadastral": "ATIVA", "data_abertura": "2009-09-02", "idade_empresa_anos": 16, "risco_nivel": "MÉDIO", "risco_motivos": "Capital social zero ou não informado", "municipio": "SAO SEBASTIAO DO CAI", "uf": "RS", "capital_social": 0, "regime_tributario_recente": "ISENTO DO IRPJ", "regime_tributario_ano": 2024, "regime_tributario_historico": { "ISENTO DO IRPJ": 7 }, "cnae_principal": "Administração de caixas escolares", "socios": [ { "nome": "CLAUDIA KICH DA SILVA", "qualificacao": "Presidente", "data_entrada": "2016-09-29", "faixa_etaria": "Entre 51 a 60 anos" } ], "status": "sucesso", "consultado_em": "2026-04-09T17:21:54.971Z" } ``` Quando um CNPJ é inválido ou inexistente, o Actor registra o erro sem parar a execução: ```json { "cnpj_consultado": "11.111.111/1111-11", "cnpj_numerico": "11111111111111", "status": "erro", "motivo": "HTTP 400: CNPJ 11.111.111/1111-11 inválido.", "consultado_em": "2026-04-09T17:26:45.804Z" } ``` *** ### Perguntas frequentes **Os dados são em tempo real?** Os dados vêm da BrasilAPI, que disponibiliza informações públicas da Receita Federal do Brasil. A base pode ter um atraso de até uma semana em relação a alterações cadastrais muito recentes. **O que acontece se um CNPJ não for encontrado ou for inválido?** O Actor registra o erro no dataset com o campo `status: "erro"` e o motivo detalhado, e continua processando os próximos CNPJs da lista sem interrupção. **Posso rodar mais de 1.000 CNPJs de uma vez?** Sim. O volume por execução depende do seu plano na Apify. Use o campo `maxItems` para controlar quantos CNPJs são processados por run e ter previsibilidade de custo antes de rodar listas grandes. **O CSV precisa ter algum formato específico?** O arquivo CSV precisa ter uma coluna com o cabeçalho `cnpj` (em minúsculas). As outras colunas são ignoradas. O separador pode ser vírgula ou ponto e vírgula. Os CNPJs podem estar com ou sem formatação. **Os dados podem ser exportados para Excel?** Sim. Ao final de cada execução, o dataset fica disponível no Console da Apify com opção de download em JSON, CSV e Excel com um clique. **Como integrar com Make ou Zapier?** A Apify tem integrações nativas com Make, Zapier, n8n e Google Sheets. Após cada execução, você pode configurar um webhook para receber os dados automaticamente ou usar o módulo da Apify disponível nessas plataformas. *** ### Limitações Os dados refletem a base pública da Receita Federal via BrasilAPI e podem ter atraso de atualização de até uma semana. Informações de contato (telefone e e-mail) nem sempre estão disponíveis — dependem do que a empresa registrou na Receita Federal. O score de risco é baseado em critérios objetivos e públicos e não substitui uma análise de crédito ou due diligence completa. *** *For international users: This Actor retrieves official Brazilian company data from Receita Federal (Brazil's federal tax authority) using CNPJ identifiers — the Brazilian equivalent of a company tax ID. It returns company name, trading name, address, partner details, CNAE activity codes (Brazil's industry classification system), complete tax regime history, and an automatic risk score that classifies each company as LOW, MEDIUM, or HIGH risk based on registration status, company age, and share capital. Designed for due diligence, B2B lead enrichment, compliance workflows, and any use case requiring structured data about Brazilian companies at scale.* # Actor input Schema ## `cnpjs` (type: `array`): Lista de CNPJs para consultar. Aceita com ou sem formatação (ex: 33.000.167/0001-01 ou 33000167000101). ## `csvContent` (type: `string`): Cole aqui o conteúdo de um arquivo CSV com uma coluna chamada 'cnpj'. Use quando tiver uma planilha com muitos CNPJs para processar em lote. ## `maxItems` (type: `integer`): Limite de CNPJs a processar nesta execução. Útil para testar com uma amostra antes de rodar a lista completa. Deixe vazio para processar todos. ## `delayMs` (type: `integer`): Tempo de espera em milissegundos entre cada consulta. O padrão de 600ms é seguro para evitar bloqueios da API. Não recomendamos valores abaixo de 300ms. ## Actor input object example ```json { "cnpjs": [ "33000167000101", "00000000000191" ], "csvContent": "cnpj,nome\n33000167000101,Petrobras\n00000000000191,Banco do Brasil", "maxItems": 100, "delayMs": 600 } ``` # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("paulovitor18/cnpj-bulk-lookup").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 = {} # Run the Actor and wait for it to finish run = client.actor("paulovitor18/cnpj-bulk-lookup").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 '{}' | apify call paulovitor18/cnpj-bulk-lookup --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=paulovitor18/cnpj-bulk-lookup", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Consulta CNPJ em Lote — Brazil Company Data", "description": "Consulte dados completos de empresas brasileiras pelo CNPJ em lote. Razão social, sócios, endereço, CNAE, situação cadastral, regime tributário e score de risco automático. Dados oficiais da Receita Federal via BrasilAPI.", "version": "0.0", "x-build-id": "6D47zhSjUoabB7uUC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/paulovitor18~cnpj-bulk-lookup/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-paulovitor18-cnpj-bulk-lookup", "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/paulovitor18~cnpj-bulk-lookup/runs": { "post": { "operationId": "runs-sync-paulovitor18-cnpj-bulk-lookup", "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/paulovitor18~cnpj-bulk-lookup/run-sync": { "post": { "operationId": "run-sync-paulovitor18-cnpj-bulk-lookup", "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": "Lista de CNPJs", "type": "array", "description": "Lista de CNPJs para consultar. Aceita com ou sem formatação (ex: 33.000.167/0001-01 ou 33000167000101).", "items": { "type": "string" } }, "csvContent": { "title": "Conteúdo CSV", "type": "string", "description": "Cole aqui o conteúdo de um arquivo CSV com uma coluna chamada 'cnpj'. Use quando tiver uma planilha com muitos CNPJs para processar em lote." }, "maxItems": { "title": "Máximo de resultados", "type": "integer", "description": "Limite de CNPJs a processar nesta execução. Útil para testar com uma amostra antes de rodar a lista completa. Deixe vazio para processar todos." }, "delayMs": { "title": "Delay entre requisições (ms)", "type": "integer", "description": "Tempo de espera em milissegundos entre cada consulta. O padrão de 600ms é seguro para evitar bloqueios da API. Não recomendamos valores abaixo de 300ms.", "default": 600 } } }, "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 } } } } } } } } } } ```