# Brazil CNPJ Lookup Scraper (`parseforge/brazil-cnpj-scraper`) Actor Lookup Brazilian companies by CNPJ. Returns full corporate record: company name, trade name, address, partners (QSA), legal nature, primary and secondary economic activities, share capital, and registration status β€” all from the Receita Federal public registry. - **URL**: https://apify.com/parseforge/brazil-cnpj-scraper.md - **Developed by:** [ParseForge](https://apify.com/parseforge) (community) - **Categories:** Business, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $6.00 / 1,000 brazilian company records 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 ![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true) ## πŸ‡§πŸ‡· Brazil CNPJ Lookup Scraper > πŸš€ πŸ‡§πŸ‡· **Lookup any Brazilian company by CNPJ in seconds.** Pull **60M+ Brazilian companies** worth of data with **22 fields per record**. No API key, no manual data entry. > πŸ•’ **Last updated:** 2026-05-05 Β· **πŸ“Š 22 fields per record** Β· **🌍 Brazil** Β· **πŸ’΅ from $0.005 per item (FREE tier)** The **Brazil CNPJ Lookup Scraper** Send a list of Brazilian CNPJs and the actor returns a structured corporate record per number from the Receita Federal public registry: razΓ£o social, nome fantasia, situação cadastral, opening date, capital social, primary and secondary CNAE codes, full address, phone, email, and the partners (QSA) registry with names, qualification, age range, and CPF mask. | 🎯 Target Audience | πŸ’‘ Primary Use Cases | |---|---| | Sales teams, compliance officers, researchers, journalists, real-estate analysts, healthcare ops | Sales prospecting, Compliance & due diligence, Investigative journalism & research, Government contracting | --- ### πŸ“‹ What the Brazil CNPJ Lookup Scraper does Highlights of every record returned: - 🏒 **Corporate identity.** razΓ£o social, nome fantasia, CIF, opening date, situação cadastral. - πŸ’° **Financials.** capital social, porte, natureza jurΓ­dica. - πŸ“ **Address.** logradouro, complemento, bairro, municΓ­pio, UF, CEP. - πŸ‘₯ **Partners (QSA).** names, qualification, entry date, age range, masked CPF/CNPJ. - 🏷️ **Activities.** primary CNAE + secondary CNAE list with descriptions. > πŸ’‘ **Why it matters:** verified, structured data delivered in seconds beats hand-curated spreadsheets that go stale within days. Run this Actor on a schedule and your downstream pipeline always has fresh records. --- ### 🎬 Full Demo _🚧 Coming soon: a 3-minute walkthrough showing how to go from sign-up to a downloaded Brazil CNPJ Lookup Scraper dataset._ --- ### βš™οΈ Input
InputTypeDefaultBehavior
cnpjsarray of stringsrequiredList of CNPJs (14 digits, with or without punctuation).
maxItemsinteger10Records to return. Free: max 10. Paid: up to 1,000,000.
**Example input:** ```json { "cnpjs": ["33000167000101", "60746948000112"], "maxItems": 10 } ```` *** ### πŸ“Š Output Each record contains **22 fields**. Download the dataset as CSV, Excel, JSON, or XML. #### 🧾 Top fields - `cnpj` - `razaoSocial` - `nomeFantasia` - `situacaoCadastral` - `dataAbertura` - `capitalSocial` - `atividadePrincipal` - `endereco` - `socios` - `telefone` - `email` *** ### ✨ Why choose this Actor - πŸ› οΈ **No infrastructure** to maintain. The Apify cloud handles scheduling, retries, proxies, and storage. - 🌍 **Verified source data.** Records come from authoritative public sources, not third-party aggregators. - πŸ” **Repeatable runs.** Schedule monthly, weekly, or hourly to keep your pipeline always fresh. - πŸ“Š **Multiple export formats.** CSV, Excel, JSON, XML out of the box. - πŸ’΅ **Pay only for what you use.** Pay-per-result-item pricing, free preview included. *** ### πŸ’Ό Business use cases #### πŸ“Š Sales prospecting Enrich CRM records with verified Brazilian company data - partners, activity, address - to score leads and segment territories. #### πŸ’Ό Compliance & due diligence Verify the situação cadastral, capital social, and director list of every CNPJ in your supplier or customer base. #### πŸ” Investigative journalism & research Trace ownership, partner overlap, and corporate structures across thousands of Brazilian companies. #### πŸ›οΈ Government contracting Validate that bidders are active, in good standing, and have the required CNAE codes for the contract. *** ### πŸ“ˆ How it compares to alternatives | Approach | Cost | Coverage | Refresh | Filters | Setup | |---|---|---|---|---|---| | **⭐ Brazil CNPJ Lookup Scraper** *(this Actor)* | $5 free credit, then pay-per-use | Full source coverage | **Live per run** | Source-native filters supported | ⚑ 2 min | | Build your own scraper | Engineering hours | Full once built | Whenever you maintain it | Custom code | 🐒 Days to weeks | | Paid managed APIs | $$$ monthly | Vendor-defined | Live | Vendor-defined | ⏳ Hours | | Third-party data dumps | Varies | Subset, often stale | Periodic | None | πŸ•’ Variable | Pick this Actor when you want broad coverage, server-side filtering, and no pipeline maintenance. *** ### πŸš€ How to use 1. [Create a free account](https://console.apify.com/sign-up?fpr=vmoqkp) on Apify (includes $5 in free credit). 2. Open the **Brazil CNPJ Lookup Scraper** Actor page. 3. Fill out the input form and click **Start**. 4. Download your dataset in CSV, Excel, JSON, or XML. *** ### 🌟 Beyond business use cases #### πŸŽ“ Research and academia Economists and political scientists can run cross-sectional studies of Brazilian corporate density by region, sector, or partner age range. #### 🎨 Personal and creative Genealogy hobbyists and family historians can trace family-business networks via the QSA registry. #### 🀝 Non-profit and civic Anti-corruption groups and journalists can audit suppliers of public contracts at scale. #### πŸ§ͺ Experimentation Data scientists can fine-tune AI on real Brazilian corporate text for entity-resolution and Portuguese NLP benchmarks. *** ### πŸ€– Ask an AI assistant about this scraper Open a ready-to-send prompt about this ParseForge actor in the AI of your choice: - πŸ’¬ [**ChatGPT**](https://chat.openai.com/?q=How%20do%20I%20use%20the%20%F0%9F%87%A7%F0%9F%87%B7%20Brazil%20CNPJ%20Lookup%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - 🧠 [**Claude**](https://claude.ai/new?q=How%20do%20I%20use%20the%20%F0%9F%87%A7%F0%9F%87%B7%20Brazil%20CNPJ%20Lookup%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - πŸ” [**Perplexity**](https://perplexity.ai/search?q=How%20do%20I%20use%20the%20%F0%9F%87%A7%F0%9F%87%B7%20Brazil%20CNPJ%20Lookup%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - πŸ…’ [**Copilot**](https://copilot.microsoft.com/?q=How%20do%20I%20use%20the%20%F0%9F%87%A7%F0%9F%87%B7%20Brazil%20CNPJ%20Lookup%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) *** ### ❓ Frequently Asked Questions #### Where does the data come from? From the Receita Federal public registry, fetched in real time via two complementary public APIs: BrasilAPI as the primary and ReceitaWS as a fallback. #### Are partners (QSA) included? Yes. Each company record includes the full QSA list with name, qualification, entry date, and (where available) age range and masked CPF/CNPJ. #### What if a CNPJ does not exist? The actor pushes a record with an `error` field set to `"CNPJ not found"` and continues processing the rest of the list. #### Can I lookup by company name? No. The Receita Federal public APIs only support direct CNPJ lookup. To find CNPJs by name, use a separate Brazilian company directory and feed the resulting CNPJs into this Actor. #### Are there rate limits? The actor uses both BrasilAPI and ReceitaWS; combined, you can process several hundred CNPJs per minute without hitting limits. Larger batches naturally take longer. *** ### πŸ”Œ Integrate with any app Connect this Actor to your stack via the [Apify integrations](https://docs.apify.com/platform/integrations) catalog: - πŸ“Š **Make / Zapier / n8n** - trigger scrapes from any business workflow. - πŸ’¬ **Slack / Discord** - get a notification when a run finishes. - πŸ“ **Google Drive / Google Sheets** - push the dataset directly into a spreadsheet. - πŸ“¨ **Gmail / Mailchimp / HubSpot** - automate outreach with the scraped leads. - πŸ”Œ **Apify CLI / SDK** - programmatic control from Python, Node.js, or any HTTP client. - ⚑ **Webhooks** - POST run results to any endpoint when complete. *** ### πŸ”— Recommended Actors - πŸ”§ [**FINRA BrokerCheck Scraper**](https://apify.com/parseforge/finra-brokercheck-scraper) - πŸ”§ [**UK Companies House Scraper**](https://apify.com/parseforge/uk-companies-house-scraper) - πŸ”§ [**SEC EDGAR Full-Text Search**](https://apify.com/parseforge/sec-edgar-full-text-search-scraper) - πŸ”§ [**Crunchbase Scraper**](https://apify.com/parseforge/crunchbase-scraper) - πŸ”§ [**OpenSecrets Scraper**](https://apify.com/parseforge/opensecrets-scraper) *** > **Disclaimer:** This Actor scrapes only publicly accessible data. We do not collect personal information beyond what is voluntarily published by the source. Do not use the data for unauthorized contact, spam, or any purpose violating applicable laws or the source site's Terms of Service. Respect [GDPR](https://gdpr.eu/), [CCPA](https://oag.ca.gov/privacy/ccpa), and applicable consumer-protection laws. ParseForge is not affiliated with any source site. *** **πŸ†˜ Need Help?** [**Open our contact form**](https://tally.so/r/BzdKgA) to request a new scraper, propose a custom data project, or report an issue. # Actor input Schema ## `cnpjs` (type: `array`): List of Brazilian CNPJs (14 digits each, with or without punctuation). Examples: '33.000.167/0001-01' or '33000167000101'. ## `maxItems` (type: `integer`): Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000 ## Actor input object example ```json { "cnpjs": [ "33000167000101", "60872504000123", "60746948000112" ], "maxItems": 10 } ``` # Actor output Schema ## `overview` (type: `string`): No description # 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": [ "33000167000101", "60872504000123", "60746948000112" ], "maxItems": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("parseforge/brazil-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": [ "33000167000101", "60872504000123", "60746948000112", ], "maxItems": 10, } # Run the Actor and wait for it to finish run = client.actor("parseforge/brazil-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": [ "33000167000101", "60872504000123", "60746948000112" ], "maxItems": 10 }' | apify call parseforge/brazil-cnpj-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=parseforge/brazil-cnpj-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Brazil CNPJ Lookup Scraper", "description": "Lookup Brazilian companies by CNPJ. Returns full corporate record: company name, trade name, address, partners (QSA), legal nature, primary and secondary economic activities, share capital, and registration status β€” all from the Receita Federal public registry.", "version": "1.0", "x-build-id": "g8RwTjrkyjiFDIjNN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~brazil-cnpj-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-brazil-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/parseforge~brazil-cnpj-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-brazil-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/parseforge~brazil-cnpj-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-brazil-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": "CNPJs", "type": "array", "description": "List of Brazilian CNPJs (14 digits each, with or without punctuation). Examples: '33.000.167/0001-01' or '33000167000101'.", "items": { "type": "string" } }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" } } }, "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 } } } } } } } } } } ```