# CNPJ Financial Market Scraper - Brazil Stock Data (`brasildados/cnpj-financial-market`) Actor Retorna indicadores financeiros de empresas de capital aberto: balanço patrimonial, DRE, acionistas e composição acionária. / Returns financial indicators for publicly traded companies: balance sheet, income statement, shareholders and stock composition. - **URL**: https://apify.com/brasildados/cnpj-financial-market.md - **Developed by:** [BrasilDados.org](https://apify.com/brasildados) (community) - **Categories:** Lead generation, Other, Developer tools - **Stats:** 1 total users, 1 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 Financial Market Data - Indicadores Financeiros de Empresas Listadas Stock exchange financials for Brazilian publicly traded companies by CNPJ. Returns balance sheet, income statement, shareholders, investor base and share composition from official capital market regulatory sources. **Only works for companies listed on the stock exchange (registered with CVM as S.A. aberta) - unlisted companies return `encontrado: false`.** Dados financeiros de empresas brasileiras de capital aberto por CNPJ. Retorna balanço patrimonial, DRE, composição acionária, principais acionistas e base de investidores a partir de fontes regulatórias oficiais do mercado de capitais. **Funciona apenas para companhias com registro ativo na CVM (S.A. listadas em bolsa) - empresas de capital fechado retornam `encontrado: false`.** --- ### Two usage modes / Duas formas de uso - **REST API (Standby)** - `POST /check`, ideal for real-time integrations. | Integração em tempo real. - **Traditional run (job)** - pass a list of CNPJs, download the dataset in JSON, CSV, Excel or XML. | Passe a lista de CNPJs e baixe o dataset. --- ### Input ```json { "cnpjs": ["33.000.167/0001-01", "60.746.948/0001-12"] } ```` | Field / Campo | Type | Required | Description / Descrição | |---|---|---|---| | `cnpjs` | `string[]` | yes / sim | 1 to **1,000** CNPJs per run. Any format (`XX.XXX.XXX/XXXX-XX` or 14 digits). Invalid CNPJs are silently dropped. 1 a 1.000 CNPJs por execução. CNPJs inválidos são descartados. | *** ### Output One record per CNPJ. / Um registro por CNPJ. ```json { "cnpj": "33000167000101", "cnpjFormatado": "33.000.167/0001-01", "consultadoEm": "2026-05-26T11:30:00.000Z", "encontrado": true, "nome": "PETROLEO BRASILEIRO S.A. PETROBRAS", "nomeNegociacao": "PETROBRAS", "codigoCVM": "9512", "codigoNegociacao": "PETR4", "codigosISIN": ["BRPETRACNOR9"], "financas": [ { "ativoTotal": 1268330000000, "ativoCirculante": 986639000000, "ativoNaoCirculante": 0, "passivoCirculante": 0, "passivoNaoCirculante": 0, "patrimonioLiquido": 362594000000, "receitaVendas": 297186000000, "custoMercadorias": 0, "lucroBruto": 160280000000, "despesasOperacionais": 0, "antesResultadoFinanceiro": 0, "resultadoFinanceiro": 16819000000, "resultadoAntesImpostos": 0, "impostosContribuicoesSociais": 0, "resultadoLiquidoContinuadas": 98891000000, "resultadoLiquidoDescontinuadas": 0, "resultadoLiquido": 98891000000, "inicioPeriodo": null, "fimPeriodo": null } ], "acionistas": [ { "nome": "União Federal", "percOrdinarias": 50.26, "percPreferenciais": 0, "percTotal": 28.68 }, { "nome": "GQG Partners LLC", "percOrdinarias": 5.64, "percPreferenciais": 5.20, "percTotal": 5.45 }, { "nome": "BNDES Participações - BNDESPAR", "percOrdinarias": 0, "percPreferenciais": 16.07, "percTotal": 6.90 }, { "nome": "BlackRock Inc", "percOrdinarias": 0, "percPreferenciais": 5.01, "percTotal": 2.15 }, { "nome": "OUTROS", "percOrdinarias": 44.10, "percPreferenciais": 71.31, "percTotal": 55.78 }, { "nome": "TOTAL", "percOrdinarias": 57.05, "percPreferenciais": 42.95, "percTotal": 100.00 } ], "investidores": { "dataReferencia": "2022-11-30T03:00:00Z", "pessoasFisicas": 858992, "pessoasJuridicas": 5807, "institucionais": 2748 }, "acoesEmCirculacao": { "dataReferencia": "2022-11-30T03:00:00Z", "qtdOrdinarias": 3701760571, "percOrdinarias": 49.74, "qtdPreferenciais": 0, "percPreferenciais": 0, "qtdTotal": 8268271696, "percTotal": 63.39 }, "composicaoAcoes": { "dataReferencia": "2014-04-02T03:00:00Z", "ordinarias": 7442454142, "preferenciais": 5602042788, "total": 13044496930 } } ``` *** ### Field reference / Referência de campos #### Identificação | Field | Description / Descrição | |---|---| | `cnpj` | CNPJ sem formatação (14 dígitos). / Unformatted CNPJ. | | `cnpjFormatado` | CNPJ no formato `XX.XXX.XXX/XXXX-XX`. | | `consultadoEm` | Timestamp da consulta (ISO 8601). | | `encontrado` | `true` se a empresa é companhia aberta registrada. / `true` if a registered publicly traded company. | | `nome` | Razão social oficial. / Official registered name. | | `nomeNegociacao` | Nome de negociação em bolsa. / Stock exchange trading name. | | `codigoCVM` | Código de registro na CVM. / CVM registration code. | | `codigoNegociacao` | Ticker da ação (ex: `PETR4`). / Stock ticker (e.g. `PETR4`). | | `codigosISIN` | Códigos ISIN de todas as classes de ações. / ISIN codes for all share classes. | #### `financas[]` - Balanço e DRE / Balance Sheet & Income Statement | Field | Description / Descrição | |---|---| | `ativoTotal` | Ativo total (BRL). / Total assets (BRL). | | `ativoCirculante` | Ativo circulante. / Current assets. | | `ativoNaoCirculante` | Ativo não circulante. / Non-current assets. | | `passivoCirculante` | Passivo circulante. / Current liabilities. | | `passivoNaoCirculante` | Passivo não circulante. / Non-current liabilities. | | `patrimonioLiquido` | Patrimônio líquido. / Shareholders' equity. | | `receitaVendas` | Receita líquida de vendas. / Net sales revenue. | | `custoMercadorias` | Custo dos produtos/mercadorias vendidos (CPV/CMV). / Cost of goods sold. | | `lucroBruto` | Lucro bruto. / Gross profit. | | `despesasOperacionais` | Despesas operacionais. / Operating expenses. | | `antesResultadoFinanceiro` | Resultado antes do resultado financeiro (EBIT). / Result before financial income/expenses (EBIT). | | `resultadoFinanceiro` | Resultado financeiro (receitas menos despesas financeiras). / Net financial income/expenses. | | `resultadoAntesImpostos` | Resultado antes dos impostos (EBT). / Pre-tax income (EBT). | | `impostosContribuicoesSociais` | IRPJ e CSLL. / Income tax and social contribution. | | `resultadoLiquidoContinuadas` | Resultado líquido de operações continuadas. / Net income from continuing operations. | | `resultadoLiquidoDescontinuadas` | Resultado líquido de operações descontinuadas. / Net income from discontinued operations. | | `resultadoLiquido` | Resultado líquido total do período. / Total net income for the period. | | `inicioPeriodo` / `fimPeriodo` | Datas do período (ISO 8601). `null` quando não informado pela fonte. / Period dates. `null` when not reported by the source. | #### `acionistas[]` - Composição Acionária / Shareholder Composition | Field | Description / Descrição | |---|---| | `nome` | Nome do acionista. / Shareholder name. | | `percOrdinarias` | Participação em ações ordinárias (ON), em %. / Ordinary (voting) share ownership %. | | `percPreferenciais` | Participação em ações preferenciais (PN), em %. / Preferred share ownership %. | | `percTotal` | Participação total, em %. / Total ownership %. | > O array inclui linhas sintéticas `TOTAL` e `AÇÕES TESOURARIA` retornadas pela fonte. / The array includes synthetic `TOTAL` and `AÇÕES TESOURARIA` rows returned by the source. #### `investidores` - Base de Investidores / Investor Base | Field | Description / Descrição | |---|---| | `dataReferencia` | Data de referência dos dados. / Data reference date. | | `pessoasFisicas` | Número de investidores pessoas físicas (varejo). / Number of individual (retail) investors. | | `pessoasJuridicas` | Número de investidores pessoas jurídicas. / Number of corporate investors. | | `institucionais` | Número de investidores institucionais. / Number of institutional investors. | #### `acoesEmCirculacao` - Free Float | Field | Description / Descrição | |---|---| | `qtdOrdinarias` / `qtdPreferenciais` / `qtdTotal` | Quantidade de ações em circulação por classe. / Float share quantity by class. | | `percOrdinarias` / `percPreferenciais` / `percTotal` | Percentual em circulação por classe. / Float percentage by class. | #### `composicaoAcoes` - Ações Emitidas / Issued Shares | Field | Description / Descrição | |---|---| | `ordinarias` / `preferenciais` / `total` | Total de ações emitidas por classe. / Total issued shares by class. | *** ### REST API (Standby) ```bash curl -X POST "https://brasildados--cnpj-financial-market.apify.actor/check" \ -H "Authorization: Bearer YOUR_APIFY_TOKEN" \ -H "Content-Type: application/json" \ -H "Accept-Encoding: gzip" --compressed \ -d '{"cnpjs": ["33.000.167/0001-01"]}' ``` A documentação interativa (Swagger UI) fica na aba **Endpoints**. / Interactive documentation (Swagger UI) is in the **Endpoints** tab. *** ### Use cases / Casos de uso - **Due diligence e análise fundamentalista** de empresas listadas. / Fundamental analysis and due diligence of listed companies. - **Monitoramento de composição acionária** - detecte entradas e saídas de acionistas relevantes. / Shareholder composition monitoring. - **Identificação de investidores institucionais** e participações qualificadas. / Institutional investor identification. - **Enriquecimento de bases de dados** com dados financeiros de companhias abertas. / Enriching corporate databases with listed company financials. - **Avaliação de solidez financeira** em processos de compliance de fornecedores. / Financial health assessment in supplier compliance workflows. - **Screening de portfólio e pesquisa de investimentos**. / Portfolio screening and investment research. *** ### Pricing **$0.10 por CNPJ** processado (pay-per-event). / **$0.10 per CNPJ** processed (pay-per-event). | Volume | Cost / Custo | |---|---| | 1 CNPJ | $0.10 | | 100 CNPJs | $10.00 | | 1,000 CNPJs | $100.00 | *** ### Data coverage / Cobertura Dados oriundos de fontes regulatórias oficiais do mercado de capitais brasileiro. Cobertura limitada a companhias abertas com registro ativo em órgão regulador. Atualização periódica conforme disponibilização pelas fontes. Nenhuma chave de API ou conta externa necessária pelo usuário final. Data from official Brazilian capital market regulatory sources. Coverage limited to publicly traded companies with active registration. Periodically updated as sources publish. No external API key or account required by the end user. *** ### Pipeline / Actors relacionados Combine com os demais actors **brasildados** para análise completa de S.A. abertas: | Actor | Quando usar no pipeline | |-------|------------------------| | [CNPJ Enrichment & Lead Search](https://apify.com/brasildados/cnpj-enrichment-lead-search) | Identifique e enriqueça CNPJs de S.A. abertas antes de buscar dados de mercado | | [Government Contracts Check](https://apify.com/brasildados/government-contracts-check) | Avalie receita pública federal — concentração de clientes governamentais | | [CNPJ KYC Compliance – PEP & Sanctions](https://apify.com/brasildados/cnpj-kyc-compliance-pep-checker) | Verifique exposição PEP e sanções dos controladores e diretores | | [Brazil CNPJ Lawsuits Check](https://apify.com/brasildados/cnpj-lawsuits-check) | Adicione risco judicial para due diligence de investimento | **Exemplo de pipeline de due diligence de investimento:** enrichment → financial market → lawsuits → KYC dos controladores. ### About / Sobre Parte da coleção **brasildados** no Apify Store - dados brasileiros para automação, compliance e análise. / Part of the **brasildados** collection on the Apify Store - Brazilian data for automation, compliance and analysis. # Actor input Schema ## `cnpjs` (type: `array`): Lista de CNPJs para consulta (formato XX.XXX.XXX/XXXX-XX ou 14 dígitos). Só retorna dados para empresas listadas em bolsa. | List of CNPJs to query (format XX.XXX.XXX/XXXX-XX or 14 digits). Only returns data for publicly traded companies. ## Actor input object example ```json { "cnpjs": [ "33.000.167/0001-01" ] } ``` # Actor output Schema ## `results` (type: `string`): Dataset with one record per CNPJ. Each record contains: company identification (name, ticker, CVM code, ISIN), financial statements (balance sheet + income statement by period), shareholders with ownership percentages, investor base breakdown and float/share composition data. | Dataset com um registro por CNPJ: identificação (nome, ticker, código CVM, ISIN), demonstrações financeiras (balanço + DRE por período), acionistas com percentuais, base de investidores e composição acionária. # 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": [ "33.000.167/0001-01" ] }; // Run the Actor and wait for it to finish const run = await client.actor("brasildados/cnpj-financial-market").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": ["33.000.167/0001-01"] } # Run the Actor and wait for it to finish run = client.actor("brasildados/cnpj-financial-market").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": [ "33.000.167/0001-01" ] }' | apify call brasildados/cnpj-financial-market --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=brasildados/cnpj-financial-market", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "CNPJ Financial Market Scraper - Brazil Stock Data", "description": "Retorna indicadores financeiros de empresas de capital aberto: balanço patrimonial, DRE, acionistas e composição acionária. / Returns financial indicators for publicly traded companies: balance sheet, income statement, shareholders and stock composition.", "version": "1.0", "x-build-id": "39ORdpuPhwmSWca3i" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/brasildados~cnpj-financial-market/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-brasildados-cnpj-financial-market", "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~cnpj-financial-market/runs": { "post": { "operationId": "runs-sync-brasildados-cnpj-financial-market", "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~cnpj-financial-market/run-sync": { "post": { "operationId": "run-sync-brasildados-cnpj-financial-market", "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", "minItems": 1, "type": "array", "description": "Lista de CNPJs para consulta (formato XX.XXX.XXX/XXXX-XX ou 14 dígitos). Só retorna dados para empresas listadas em bolsa. | List of CNPJs to query (format XX.XXX.XXX/XXXX-XX or 14 digits). Only returns data for publicly traded companies.", "items": { "type": "string" } } } }, "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 } } } } } } } } } } ```