# BrasilAPI CNPJ Company Scraper (`crawlerbros/brasil-api-cnpj-scraper`) Actor Look up Brazilian company data using the BrasilAPI CNPJ endpoint. Input CNPJ numbers to retrieve official Receita Federal data: company name, trade name, legal status, CNAE industry codes, address, partners (QSA), founding date, capital, and tax regime. Free, no authentication required. - **URL**: https://apify.com/crawlerbros/brasil-api-cnpj-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Developer tools, Automation, Integrations - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 ## BrasilAPI CNPJ Company Scraper Look up Brazilian company data instantly using the free [BrasilAPI CNPJ endpoint](https://brasilapi.com.br/api/cnpj/v1/). Enter one or more CNPJ numbers and receive official **Receita Federal** (Brazilian IRS) data — no API key, no login, no cost. ### What You Get - Official company name (`razaoSocial`) and trade name (`nomeFantasia`) - Registration status: Active, Suspended, Void, Closed, Null - Primary and secondary CNAE industry codes with descriptions - Full address: street, number, neighbourhood, city, state, postal code - Contact details: phone, email - Company size classification (Micro, Small, Other) - Legal nature (`naturezaJuridica`) and unit type (Headquarters / Branch) - Share capital (`capitalSocial`) in BRL - Founding date (`dataInicioAtividade`) - Tax regime (`regimeTributario`) — latest year - Partner/shareholder list (QSA) with name, role, age bracket, and entry date - Direct source URL for each company record ### Input | Parameter | Type | Required | Default | Description | |---|---|---|---|---| | `cnpjs` | array | Yes | — | List of CNPJ numbers to look up. Accepts any format: `18.236.120/0001-58`, `18236120000158`, or mixed. | | `includePartners` | boolean | No | `true` | Include the partner/shareholder list (QSA) in the output. | | `includeSecondaryActivities` | boolean | No | `true` | Include secondary CNAE activity codes in the output. | #### Example Input ```json { "cnpjs": ["18.236.120/0001-58", "47960950000121", "33000167000101"], "includePartners": true, "includeSecondaryActivities": true } ```` ### Output Each CNPJ lookup produces one dataset record. All fields are omit-empty — only populated fields appear. #### Sample Record ```json { "cnpj": "18236120000158", "razaoSocial": "MAGAZINE LUIZA S.A.", "nomeFantasia": "MAGAZINE LUIZA", "situacaoCadastralCodigo": 2, "situacaoCadastral": "Ativa", "dataSituacaoCadastral": "2018-01-01", "porteCodigo": 5, "porte": "Demais", "tipoUnidade": "Matriz", "naturezaJuridica": "2046 - Sociedade Anônima Aberta", "cnaeFiscal": 4752100, "cnaeDescricao": "Comércio varejista especializado de equipamentos e suprimentos de informática", "cnaesSecundarios": [ { "codigo": 4731800, "descricao": "Comércio varejista de combustíveis para veículos automotores" } ], "endereco": { "logradouro": "Avenida Franca", "numero": "1234", "bairro": "Centro", "municipio": "Franca", "uf": "SP", "cep": "14400000" }, "municipio": "Franca", "uf": "SP", "cep": "14400000", "telefone1": "01632163000", "capitalSocial": 9800000000.0, "dataInicioAtividade": "1996-01-01", "socios": [ { "nome": "LUIZA HELENA TRAJANO INÁCIO RODRIGUES", "qualificacao": "Presidente", "faixaEtaria": "61 a 70 anos", "dataEntradaSociedade": "2009-05-01" } ], "sourceUrl": "https://brasilapi.com.br/api/cnpj/v1/18236120000158" } ``` #### Output Fields Reference | Field | Type | Description | |---|---|---| | `cnpj` | string | 14-digit CNPJ number | | `razaoSocial` | string | Official corporate name | | `nomeFantasia` | string | Trade/brand name | | `situacaoCadastralCodigo` | integer | Status code (1–8) | | `situacaoCadastral` | string | Status label: `Ativa`, `Suspensa`, `Inapta`, `Baixada`, `Nula` | | `dataSituacaoCadastral` | string | Date of last status change (YYYY-MM-DD) | | `porteCodigo` | integer | Size code | | `porte` | string | Size label: `Micro Empresa`, `Empresa de Pequeno Porte`, `Demais` | | `tipoUnidade` | string | `Matriz` (headquarters) or `Filial` (branch) | | `naturezaJuridica` | string | Legal nature code and description | | `cnaeFiscal` | integer | Primary CNAE industry code | | `cnaeDescricao` | string | Primary CNAE description | | `cnaesSecundarios` | array | Secondary CNAE codes `[{codigo, descricao}]` | | `endereco` | object | Full address object | | `municipio` | string | City name (top-level) | | `uf` | string | State abbreviation (e.g., `SP`, `RJ`) | | `cep` | string | Postal code | | `telefone1` | string | Primary phone (DDD + number) | | `telefone2` | string | Secondary phone | | `email` | string | Company email address | | `capitalSocial` | number | Share capital in BRL | | `dataInicioAtividade` | string | Founding / activity start date | | `regimeTributario` | string | Tax regime (latest year available) | | `socios` | array | Partner list `[{nome, qualificacao, faixaEtaria, dataEntradaSociedade}]` | | `sourceUrl` | string | BrasilAPI URL for this record | ### FAQ **What is a CNPJ?** CNPJ (*Cadastro Nacional da Pessoa Jurídica*) is Brazil's 14-digit national company registration number, issued by the Receita Federal (Brazilian IRS). Every legally registered Brazilian company has one. **Where does the data come from?** Data is sourced from BrasilAPI's free CNPJ endpoint, which mirrors the official Receita Federal database. It is updated periodically and reflects the same data you would find on the government's own portal. **Does this require an API key or login?** No. BrasilAPI's CNPJ endpoint is completely free and public — no authentication required. **What CNPJ formats are accepted?** Any common format: formatted (`18.236.120/0001-58`), unformatted (`18236120000158`), or mixed in the same input list. **What happens if a CNPJ is not found or invalid?** Invalid CNPJs (not 14 digits after stripping punctuation) are skipped with a logged warning. CNPJs that return 404 from the API (genuinely not found in Receita Federal) are also skipped. **How many CNPJs can I look up per run?** There is no hard limit — you can pass as many as needed. The actor adds a short delay between requests to respect BrasilAPI's fair-use policy. **Can I disable the partner list to get smaller records?** Yes. Set `includePartners` to `false` to omit the `socios` field. Similarly, set `includeSecondaryActivities` to `false` to omit `cnaesSecundarios`. **What is the QSA / `socios` field?** QSA stands for *Quadro Societário de Administração* — the official list of company partners and administrators registered with the Receita Federal. **Is this suitable for bulk CNPJ validation?** Yes. You can pass thousands of CNPJs in a single run. Records with invalid or non-existent CNPJs are silently skipped, so you only receive valid results. # Actor input Schema ## `cnpjs` (type: `array`): List of Brazilian CNPJ numbers to look up. Can include formatting (dots, slashes, hyphens) or plain 14-digit numbers. Example: \["18.236.120/0001-58", "47960950000121"]. ## `includePartners` (type: `boolean`): Whether to include the company's partner/shareholder list (Quadro Societário de Administração) in the output. ## `includeSecondaryActivities` (type: `boolean`): Whether to include the list of secondary CNAE industry codes in the output. ## Actor input object example ```json { "cnpjs": [ "18236120000158", "47960950000121", "03007331000100", "60746948000112", "33000167000101" ], "includePartners": true, "includeSecondaryActivities": true } ``` # Actor output Schema ## `companies` (type: `string`): Dataset containing all scraped Brazilian company records. # 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": [ "18236120000158", "47960950000121", "03007331000100", "60746948000112", "33000167000101" ], "includePartners": true, "includeSecondaryActivities": true }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/brasil-api-cnpj-scraper").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": [ "18236120000158", "47960950000121", "03007331000100", "60746948000112", "33000167000101", ], "includePartners": True, "includeSecondaryActivities": True, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/brasil-api-cnpj-scraper").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": [ "18236120000158", "47960950000121", "03007331000100", "60746948000112", "33000167000101" ], "includePartners": true, "includeSecondaryActivities": true }' | apify call crawlerbros/brasil-api-cnpj-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/brasil-api-cnpj-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "BrasilAPI CNPJ Company Scraper", "description": "Look up Brazilian company data using the BrasilAPI CNPJ endpoint. Input CNPJ numbers to retrieve official Receita Federal data: company name, trade name, legal status, CNAE industry codes, address, partners (QSA), founding date, capital, and tax regime. Free, no authentication required.", "version": "1.0", "x-build-id": "HT85XR9T4sadGq8co" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~brasil-api-cnpj-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-brasil-api-cnpj-scraper", "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/crawlerbros~brasil-api-cnpj-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-brasil-api-cnpj-scraper", "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/crawlerbros~brasil-api-cnpj-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-brasil-api-cnpj-scraper", "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": "CNPJ Numbers", "type": "array", "description": "List of Brazilian CNPJ numbers to look up. Can include formatting (dots, slashes, hyphens) or plain 14-digit numbers. Example: [\"18.236.120/0001-58\", \"47960950000121\"]." }, "includePartners": { "title": "Include Partners (QSA)", "type": "boolean", "description": "Whether to include the company's partner/shareholder list (Quadro Societário de Administração) in the output.", "default": true }, "includeSecondaryActivities": { "title": "Include Secondary CNAE Activities", "type": "boolean", "description": "Whether to include the list of secondary CNAE industry codes in the output.", "default": true } } }, "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 } } } } } } } } } } ```