Brazil CNPJ Scraper: Company Data, Partners, Phone and Email
Pricing
from $1.44 / 1,000 companies
Brazil CNPJ Scraper: Company Data, Partners, Phone and Email
Look up Brazilian companies by CNPJ or find them by CNAE activity, state and city: legal and trade name, status, opening date, capital, size, Simples and MEI, address, phone, email and partners (QSA) from the Receita Federal open data. No login.
Pricing
from $1.44 / 1,000 companies
Rating
0.0
(0)
Developer
The Mine Works
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
4 days ago
Last modified
Categories
Features
Share
Returns Brazilian companies from the Receita Federal open CNPJ data: look up any CNPJ, or find companies by activity (CNAE code or plain words), state and city. One row per company with legal and trade name, status, opening date, activity codes, size, share capital, Simples Nacional and MEI flags, full address, phone, email and partners (QSA). No login, no cookies, no API key. You pay $1.80 per 1,000 companies on the Free plan and $1.44 per 1,000 on the Gold plan, plus a $0.001 start fee per run. The email costs nothing extra.
From The Mine Works, with over 340,000 runs across 330+ public actors.
Updated 12 Nov 2026: first release. CNPJ lookup with three fallback sources, company search by CNAE code or activity words, state, city name and legal nature, filters for status, size, MEI, head office, opening date, share capital, phone and email, and the registered email in every row. Bookmark this Actor on its Store page so it is one click away next time.
Why choose this actor?
- Search the way you think. Type a city as "Campinas, SP" and an activity as "contabilidade" or "dentista"; the actor turns them into the IBGE code and CNAE codes and lists the codes it used in the summary row. Other CNPJ actors ask for numeric municipality codes.
- Lead lists that are ready to call. Active companies only by default, plus filters to drop MEIs and branches, keep companies opened after a date, above a share capital, or with a phone or email. Filtered out records are never charged. In our test of 400 dental clinics in Bahia, Pernambuco and Ceara, 398 had a phone and 383 an email.
- Email included at the same price. The email registered with the Receita Federal comes in every row from a second public source, with no extra event.
- Pay per company, nothing for errors. Invalid CNPJs, CNPJs that do not exist, the summary row and duplicates are never charged.
Part of The Mine Works Company and business data family: Company Domain Finder, GST Taxpayer Lookup, Company KYB Resolver, SEC EDGAR Filings Scraper, EU VAT Checker (VIES), Tech Stack Detector.
Try it in one minute
Paste this into the input (JSON view) and press Start. It returns 20 active custom software companies in Sao Paulo state with phone, email and partners. It took 3 seconds in our test run on Apify:
{"cnaes": ["6201501"],"states": ["SP"],"maxItems": 20}
Or look up companies you already have:
{"cnpjs": ["00.000.000/0001-91", "33.683.111/0002-80"]}
Apify's free plan includes $5 of credit every month, which covers about 2,700 companies at this actor's price.
Copy to your AI assistant
themineworks/brazil-cnpj-scraper on Apify. Reads Brazilian company data (CNPJ) from the Receita Federal open data and returns one flat row per company, no login. Call ApifyClient("TOKEN").actor("themineworks/brazil-cnpj-scraper").call(run_input={"cnaes": ["6201501"], "states": ["SP"], "maxItems": 100}), then client.dataset(run["defaultDatasetId"]).list_items().items. Give cnpjs (list of CNPJ numbers, any format, up to 10000) for lookups, and/or search filters: cnaes (7 digit CNAE codes), activityKeywords (Portuguese words or everyday words such as software, dentista, contabilidade), states (UF codes), cities ("Campinas, SP" or IBGE codes), legalNatureCodes (4 digits). Optional: cnaeMatch (primary or any, default primary), statuses (default ["active"]; also closed, inapt, suspended, null; [] for all), companySizes (micro, small, other, not_informed), excludeMei, headOfficeOnly, openedFrom and openedTo (YYYY-MM-DD), minShareCapital, requirePhone, requireEmail, includeEmail (default true), maxItems (search results, default 100, up to 20000). Company rows have no _type field and carry cnpj, cnpj_formatted, cnpj_root, legal_name, trade_name, is_head_office, status, status_en, status_date, status_reason, special_situation, opening_date, company_age_years, main_cnae, main_cnae_description, secondary_cnae_codes, secondary_cnaes, legal_nature_code, legal_nature, company_size, company_size_en, share_capital, simples_nacional, simples_since, simples_until, mei, mei_since, mei_until, tax_regime_latest, tax_regime_year, street_type, street, number, complement, neighborhood, city, city_ibge_code, state, zip_code, country, foreign_city, full_address, phone_1, phone_2, fax, phones_e164, email, responsible_federal_entity, partners (name, type, qualification, entry_date, age_range, cpf_cnpj_masked, country, legal_representative), partner_count, partner_names, source (lookup or search), input, source_url, scraped_at. Each run also writes one row with _type "summary", one with _type "info" when companies were delivered, and a row with _type "error" for each input that could not be used; none of these is charged. Full spec: GET https://api.apify.com/v2/acts/themineworks~brazil-cnpj-scraper/builds/default (Bearer TOKEN), which returns inputSchema and readme.
Key features
- Lookup and search in one run. Put CNPJs in
cnpjsfor one row each, whatever the status, and filters in the search fields for new companies; both run in the same job. Dots, slash and dash are optional, and CNPJs that lost their leading zero in a spreadsheet are fixed. - Activity by code or by words.
cnaestakes 7 digit subclasses with or without the mask (6201501or6201-5/01).activityKeywordsmatches the official CNAE wording (in Portuguese) and understands everyday words such as software, dentista, advogados, academia, farmacia, salao de beleza and real estate.cnaeMatchpicks the main activity only or main and secondary. - City names, not codes.
citiesaccepts "Curitiba, PR", "Porto Alegre" or the 7 digit IBGE code. A name used in more than one state is flagged in the summary so you can add the state. - Filters before you pay. Status (active by default), company size, MEI, head office, opening date range, minimum share capital, phone present, email present. Records that fail a filter are skipped and never charged.
- Partners and tax details. The partner list (QSA) with qualification, entry date, age range and the masked CPF exactly as the Receita Federal publishes it, plus Simples Nacional and MEI dates and the latest declared tax regime.
- Stops cleanly. A search reads at most 50 registry records per company you ask for (at least 2,000), so a filter that matches almost nothing ends instead of paging the whole country. Lookups fall back to a second and a third source. The summary row says why a run ended.
How to use it
Basic: enrich a list of CNPJs
{"cnpjs": ["60.746.948/0001-12", "33000167000101", "02558157000162"]}
One row per CNPJ with status, address, phone, email and partners. CNPJs that are not valid or not found get an error row and are not charged.
Lead list: accounting firms in two states
{"activityKeywords": ["contabilidade"],"states": ["MG", "RJ"],"headOfficeOnly": true,"excludeMei": true,"maxItems": 1000}
Active head offices with CNAE 6920601, no MEIs. In our test, 993 of 1,000 rows had a phone and 949 an email.
New companies in your cities
{"cnaes": ["5611201", "5611203", "4729699"],"cities": ["Curitiba, PR", "Porto Alegre", "Florianopolis"],"openedFrom": "2026-01-01","requireEmail": true,"maxItems": 300}
Restaurants, snack bars and food shops opened this year, with an email. Run it monthly on a schedule to catch each new batch.
Bigger companies only
{"activityKeywords": ["software"],"states": ["SP"],"companySizes": ["other"],"minShareCapital": 1000000,"maxItems": 500}
companySizes: ["other"] keeps companies above the small business (EPP) limit; minShareCapital is in BRL.
Input parameters
| Parameter | Type | Default | What it does |
|---|---|---|---|
cnpjs | array of strings | empty | CNPJs to look up, any format, up to 10,000. |
cnaes | array of strings | empty | 7 digit CNAE subclasses. |
activityKeywords | array of strings | empty | Words matched against CNAE descriptions; the codes used are in the summary. |
cnaeMatch | string | primary | primary (main activity) or any (main or secondary). |
states | array of strings | empty | Two letter state codes or names. |
cities | array of strings | empty | City names with the state, or IBGE codes. |
legalNatureCodes | array of strings | empty | 4 digit natureza juridica codes, e.g. 2062. |
statuses | array | ["active"] | Statuses kept in search results; empty for all. |
companySizes | array | empty | micro, small, other, not_informed. |
excludeMei | boolean | false | Skip MEIs. |
headOfficeOnly | boolean | false | Skip branches. |
openedFrom, openedTo | string | empty | Opening date range, YYYY-MM-DD. |
minShareCapital | integer | empty | Minimum share capital in BRL. |
requirePhone, requireEmail | boolean | false | Keep only companies with a phone or an email. |
includeEmail | boolean | true | Add the registered email. |
maxItems | integer | 100 | Most companies from the search, 1 to 20,000. Lookups are not counted. |
A search needs at least one of cnaes, activityKeywords, states, cities or legalNatureCodes. If you fill a field and none of its values can be used (a city that does not exist, words that match no activity), the search is not run, so you never get companies you did not ask for.
What data do you get?
One row per company. Company rows have no _type field; the summary, info and error rows do, so a filter on _type separates them.
| Field | What it is |
|---|---|
cnpj, cnpj_formatted, cnpj_root | CNPJ as 14 digits, as 00.000.000/0001-91, and the 8 digit root shared with branches |
legal_name, trade_name | Razao social and nome fantasia |
is_head_office | true for the matriz, false for a filial |
status, status_en, status_date, status_reason | Situacao cadastral (ATIVA, BAIXADA, INAPTA, SUSPENSA, NULA), in English, its date and reason |
special_situation | Situacao especial, when any |
opening_date, company_age_years | Activity start date and years since |
main_cnae, main_cnae_description | Main activity |
secondary_cnae_codes, secondary_cnaes | Secondary activities, codes and code with description |
legal_nature_code, legal_nature | Natureza juridica |
company_size, company_size_en | Porte (MICRO EMPRESA, EMPRESA DE PEQUENO PORTE, DEMAIS) and in English |
share_capital | Declared share capital in BRL |
simples_nacional, simples_since, simples_until | Simples Nacional option and dates |
mei, mei_since, mei_until | MEI option and dates |
tax_regime_latest, tax_regime_year | Latest declared tax regime, e.g. LUCRO PRESUMIDO, and its year |
street_type, street, number, complement, neighborhood | Address parts |
city, city_ibge_code, state, zip_code | Municipality, IBGE code, UF and CEP |
country, foreign_city | For companies registered abroad |
full_address | The address in one line |
phone_1, phone_2, fax, phones_e164 | Phones as area code plus number, and in +55 format |
email | Registered email, lowercase |
responsible_federal_entity | For public bodies |
partners, partner_count, partner_names | QSA: name, type (person, company, foreign), qualification, entry_date, age_range, cpf_cnpj_masked, country, legal_representative |
source, input, source_url | lookup or search, the CNPJ as you gave it, and a link to the record |
scraped_at | When the row was written |
Summary row (_type: "summary", never charged): mode, cnpjs_requested, cnpjs_found, cnpjs_not_found, cnpjs_failed, search_pages_read, search_records_scanned, search_records_matched, filtered_out (per filter), search_end, search_filters (the CNAE codes and cities actually used), activity_keywords (codes found per word), companies_delivered, charged_for, email_lookups, email_found, http_requests, http_megabytes, shortfall_reason when fewer companies came back than asked. The same summary is saved as the OUTPUT record of the run.
Example row
{"cnpj": "59142996000112","cnpj_formatted": "59.142.996/0001-12","legal_name": "KG & AT SMILE LTDA","trade_name": "CONSULTORIO DRA KAUANNE GALISA","is_head_office": true,"status": "ATIVA","status_en": "active","opening_date": "2025-01-28","main_cnae": "8630504","main_cnae_description": "Atividade odontológica","legal_nature": "Sociedade Empresária Limitada","company_size": "MICRO EMPRESA","share_capital": 44000,"simples_nacional": true,"mei": false,"full_address": "PRACA FLAVIO SILVANY, 130, ANDAR 1 SALA 110, CENTRO, ITABERABA BA, CEP 46880000","city": "ITABERABA","state": "BA","phone_1": "7583163883","phones_e164": ["+557583163883"],"email": "khaa.tenorio@hotmail.com","partner_count": 2,"partner_names": "ADRIANA TENORIO BISPO; KAUANNE BISPO GALISA","source": "search","scraped_at": "2026-11-11T20:23:05.293Z"}
Pricing
Pay per event: you pay for the companies you receive, plus a flat $0.001 per run, whatever memory you choose. The email costs nothing extra.
| Event | When it is charged | Free plan | Bronze (Starter) | Silver (Scale) | Gold (Business) |
|---|---|---|---|---|---|
company | Once per company row stored in your dataset | $1.80 per 1,000 | $1.80 per 1,000 | $1.62 per 1,000 | $1.44 per 1,000 |
run-start | Once per run, after the first company record came back | $0.001 | $0.001 | $0.001 | $0.001 |
Never charged:
- invalid CNPJs and CNPJs the registry does not have (each gets an error row);
- search records that fail your filters (status, size, MEI, head office, dates, capital, phone, email);
- a company found twice in one run;
- the summary, info and error rows;
- a run with no valid input, or one whose search finds nothing: the start fee is charged only once a company record came back;
- anything past your "Max cost per run". The actor checks the budget before each batch of rows and stops while the total is still below your limit.
How it compares
| Actor | Price per 1,000 on the Free plan | Start fee | Search by | City input | |
|---|---|---|---|---|---|
| This actor | $1.80 | $0.001 per run | CNAE codes or words, state, city, legal nature | Name or IBGE code | Included |
| Brazil Company Registry Data & CNPJ Lookup by jungle_synthesizer | $2.00 | $0.10 per GB of memory | CNAE code, state, municipality code, legal nature, partner CPF | IBGE or SIAFI code | Optional, billed as one more result |
| Brazil CNPJ Receita Federal Scraper by epicscrapers | $0.90 | $0.00005 per GB of memory | CNAE code, state, municipality code, legal nature, partner CPF | IBGE or SIAFI code | Listed as a field |
| CNPJ Lead Scraper API by brasildados | $70.00 | $0.30 per GB of memory | CNAE codes, states, size, status, up to 500 per run | No | Yes |
Checked 11 Nov 2026 from the public Store listings.
Run it on a schedule
- Open the actor in Apify Console, set your input and click Save as a new task.
- In the task, open Schedules, click Add schedule and pick how often. The registry data is refreshed about once a month, so monthly or weekly is enough.
- With
openedFromset to the start of the month, each run brings the companies opened since then. - Optional: add an integration (Google Sheets, a CRM through Make or n8n, a webhook) so each run lands where your sales team works.
FAQ
Where does the data come from?
From the Receita Federal open CNPJ data (Dados Abertos do CNPJ), published by the Brazilian government and refreshed about once a month. The actor reads it through public mirrors of that data: minhareceita.org for search and lookup, BrasilAPI as a second lookup source, and api.opencnpj.org for the registered email and as a third lookup source.
Do I need an account, cookies or an API key?
No account, no cookies and no API key. Nothing to set up and no proxy needed.
How fresh is the data?
As fresh as the latest monthly Receita Federal release. A company opened or closed in the last few weeks may not show the change yet.
How many companies can I get?
Up to 20,000 per run from the search and up to 10,000 CNPJ lookups. For more, split the search by state or city and run them in parallel.
Why did my search return fewer companies than I asked for?
Your filters left fewer matches than maxItems, or the search reached its scan limit (50 registry records read per company asked for). The summary row shows how many records were read and how many each filter removed in filtered_out.
What do the masked CPFs mean?
The Receita Federal publishes partner CPFs with the first three and last two digits hidden (***258998**). The actor returns them exactly as published, never unmasked.
Is it legal to scrape Brazilian CNPJ data?
The CNPJ registry is open government data that the Receita Federal publishes for anyone to download and reuse. Rows can still hold personal data, for example the email and phone of an MEI, which is often one person. Under the LGPD you need a lawful basis for how you use it, such as legitimate interest for B2B contact, and you must honour opt out requests. Use excludeMei to keep one person businesses out of a list. This is general information, not legal advice.
Which formats can I download?
JSON, CSV, Excel, XML, RSS and HTML from the run's Storage tab or through the API. In CSV and Excel, the partners list is flattened into columns; partner_names gives all names in one cell.
Can I use it from Claude, ChatGPT or Cursor (MCP)?
Yes, through Apify's MCP server. Connector URL: https://mcp.apify.com/?tools=themineworks/brazil-cnpj-scraper
- Claude: Settings > Connectors > Add custom connector, paste the URL, sign in with Apify.
- ChatGPT: turn on developer mode, add an MCP connector with the URL, sign in with Apify.
- Cursor or VS Code: add it as an HTTP MCP server with that URL.
- Claude Code:
claude mcp add -t http brazil-cnpj-scraper "https://mcp.apify.com/?tools=themineworks/brazil-cnpj-scraper"
How long does a run take?
In our tests on Apify (12 Nov 2026): 3 seconds for the "Try it" input (20 companies), 5 seconds for 60 CNPJ lookups, 34 seconds for 400 dental clinics in three states and 73 seconds for 272 new food businesses in three cities, a search that read 4,011 registry records to find them, and 134 seconds for 1,000 bakeries in two states. The email lookups, one per company, set most of the time, and the email source sometimes asks callers to slow down, when the actor waits as asked; turn includeEmail off for the fastest runs.
Integrations
- Google Sheets: send each run's companies to a sheet with Apify's Google Sheets integration; one row per company fits a sheet as is.
- Make, Zapier and n8n: start a run and read its dataset with the Apify apps and nodes, for example "new dental clinics in our cities every month into the CRM".
- Clay and other enrichment tools: call the actor with one CNPJ per record through the API; a single lookup returns in a few seconds.
- Webhooks: have Apify call your URL when a run succeeds, then fetch the dataset.
- MCP clients: Claude, ChatGPT, Cursor and VS Code can run it as a tool through the connector URL in the FAQ.
If this actor saved you time, a short rating on the Store helps other buyers find it.
More from The Mine Works
Company and business data
- Company Domain Finder
- GST Taxpayer Lookup
- Company KYB Resolver
- SEC EDGAR Filings Scraper
- EU VAT Checker (VIES)
- Tech Stack Detector
- Bundesanzeiger Scraper
- Domain to LinkedIn URL Resolver
- World Bank Trade Scraper
- US Import Records
- Y Combinator Scraper
- Norway Company Register
Social media and video
Leads and business directories
Marketing, SEO and reviews
Real estate
Science, health and government data
Jobs and hiring
E-commerce and marketplaces
Food and local services
Developer and AI tools
More tools
Support
Found a CNPJ that returns wrong data, or an activity word that finds the wrong CNAE? Open an issue in the Issues tab with the input and the run ID, and we will look at it. For a field you need or a new source, email dmineworks@gmail.com.
Look up any Brazilian CNPJ or find companies by activity, state and city, and get every company back as one row with status, address, phone, email and partners, no login.

