Brazil CNPJ Receita Federal Crawler

Look up any Brazilian company by its CNPJ and get the full official Receita Federal registry record — legal identity, registration status, address, contacts, business activities, share capital, tax profile, and the complete partner list — in clean JSON. Paste one CNPJ or ten thousand, or discover companies by state, activity, city, and legal form. Built for sales, compliance, and research teams who need verified Brazilian company data without wrestling government portals one search at a time.

Why This Scraper?

• Bulk CNPJ enrichment with no per-run cap — paste 10 or 10,000 CNPJ numbers and get a full record for every one, with no volume limit on direct lookups.
• Punctuation-tolerant input — accepts CNPJs in any format, 11.222.333/0001-81 or 11222333000181, and normalizes them automatically. No pre-cleaning required.
• Complete partner list (QSA) — every partner with name, role (qualificação), entry date, and age range, plus a partnerCount on each company for instant ownership sizing.
• Full activity profile — primary CNAE code and description, plus every secondary CNAE code with its plain-language description.
• Tax status at a glance — Simples Nacional and MEI opt-in flags with their opt-in and opt-out dates, plus a year-by-year tax-regime history.
• Registration status with reason and date — resolves across all 5 official statuses: ATIVA, SUSPENSA, INAPTA, BAIXADA, and NULA.
• 7-part address breakdown — street, number, complement, neighborhood, city, state, and CEP as separate fields, plus up to two phone numbers, a fax line, and email.
• Headquarters vs. branch flag — each row marks whether the establishment is the matriz (head office) or a filial (branch).
• Discovery across all 27 Brazilian states — sample companies by state (UF), CNAE activity, city, legal form, and registration status when you don't yet have CNPJ numbers.

Use Cases

Lead Generation & Sales Prospecting

• Build B2B contact lists with company email, phone, and full postal address
• Enrich existing lead lists with official trade names, size, and activity codes
• Qualify prospects by company size (porte) and share capital before outreach
• Target suppliers or buyers by CNAE activity in a specific state or city

Compliance, KYC & Due Diligence

• Verify a counterparty's legal name, CNPJ, and active/closed registration status
• Screen the full partner (QSA) structure for ownership and control checks
• Confirm tax standing via Simples Nacional and MEI flags before onboarding
• Document opening date, status reason, and status date for audit trails

Supplier & Partner Vetting

• Validate that a vendor's CNPJ is ATIVA and not BAIXADA (closed) or SUSPENSA
• Cross-check registered activity codes against the services a supplier offers
• Review share capital and company size to gauge counterparty stability
• Confirm the head-office vs. branch status of the entity you're contracting

Market & Competitive Research

• Sample companies operating under a given CNAE activity across states
• Map competitor concentration by city and legal form
• Analyze the mix of company sizes and legal structures in a sector
• Track registration status distribution within a target market segment

Getting Started

Look up specific companies

The simplest way to start — paste the CNPJs you already have:

{
    "cnpjs": ["33.000.167/0001-01", "00000000000191"]
}

Discover companies by filter

Leave cnpjs empty and sample companies matching your criteria:

{
    "state": "SP",
    "status": "ATIVA",
    "maxResults": 20
}

Combined, targeted discovery

Stack filters to narrow to exactly the companies you want:

{
    "state": "PR",
    "city": "CURITIBA",
    "activityCode": "6201500",
    "legalFormCode": "2062",
    "status": "ATIVA",
    "maxResults": 20
}

Input Reference

What to Look Up

Parameter	Type	Default	Description
cnpjs	string[]	[]	One or more CNPJ numbers to look up directly, with or without punctuation. When provided, the filters below are ignored and every listed company is returned in full.

Discovery Filters

Used only when cnpjs is empty. Companies must match every filter you set.

Parameter	Type	Default	Description
state	select	All states	Brazilian state (UF) to search, e.g. São Paulo (SP) or Rio de Janeiro (RJ). Covers all 27 states.
activityCode	string	""	7-digit CNAE activity code, e.g. 6201500 (software) or 4711301 (supermarkets). Matches primary or secondary activity.
city	string	""	City name, e.g. SAO PAULO or RIO DE JANEIRO. Accents optional.
legalFormCode	string	""	4-digit legal-form (natureza jurídica) code, e.g. 2062 (limited company) or 2135 (sole proprietor).
status	select	Any status	Registration status: Active (ATIVA), Suspended (SUSPENSA), Ineligible (INAPTA), Closed (BAIXADA), or Null (NULA).

Limits

Parameter	Type	Default	Description
maxResults	integer	100	How many companies to collect. Set to 0 for as many as possible. Direct CNPJ lookups always return every company you list, regardless of this cap.

Output

Each row is one company establishment (head office or branch) as a flat JSON object. Fields the registry leaves blank are omitted.

{
    "cnpj": "00000000000191",
    "cnpjFormatted": "00.000.000/0001-91",
    "companyName": "BANCO DO BRASIL SA",
    "tradeName": "DIRECAO GERAL",
    "establishmentType": "MATRIZ",
    "registrationStatus": "ATIVA",
    "registrationStatusReason": "SEM MOTIVO",
    "registrationStatusDate": "2005-11-03",
    "openingDate": "1966-08-01",
    "companySize": "DEMAIS",
    "shareCapital": 120000000000.0,
    "legalForm": "Sociedade de Economia Mista",
    "legalFormCode": "2038",
    "primaryActivityCode": "6422100",
    "primaryActivityDescription": "Bancos multiplos, com carteira comercial",
    "secondaryActivities": [
        { "code": "6499999", "description": "Outras atividades de servicos financeiros" }
    ],
    "street": "SBS QUADRA 01 BLOCO G LOTE 32",
    "number": "S/N",
    "complement": "EDIFICIO SEDE III",
    "neighborhood": "ASA SUL",
    "city": "BRASILIA",
    "state": "DF",
    "zipCode": "70073901",
    "country": "BRASIL",
    "phone1": "6134939002",
    "phone2": "6134933002",
    "email": "sede@bb.com.br",
    "simplesNacional": false,
    "mei": false,
    "taxRegimes": [
        { "year": 2020, "taxation": "LUCRO REAL" }
    ],
    "partners": [
        { "name": "MARIA DE FATIMA EXAMPLE", "role": "Diretor", "since": "2019-04-25", "ageRange": "51 a 60 anos" }
    ],
    "partnerCount": 1,
    "sourceUrl": "https://www.gov.br/receitafederal/cnpj/00000000000191"
}

Core Identity

Field	Type	Description
cnpj	string	14-digit CNPJ, digits only
cnpjFormatted	string	CNPJ with standard punctuation (00.000.000/0001-91)
companyName	string	Official legal name (razão social)
tradeName	string	Trade name (nome fantasia)
establishmentType	string	MATRIZ (head office) or FILIAL (branch)
companySize	string	Company size band (porte)
shareCapital	number	Registered share capital in BRL
legalForm	string	Legal form description (natureza jurídica)
legalFormCode	string	4-digit legal-form code
openingDate	string	Date the establishment opened

Registration Status

Field	Type	Description
registrationStatus	string	ATIVA, SUSPENSA, INAPTA, BAIXADA, or NULA
registrationStatusReason	string	Reason text for the current status
registrationStatusDate	string	Date the current status took effect

Activities

Field	Type	Description
primaryActivityCode	string	7-digit primary CNAE code
primaryActivityDescription	string	Primary activity in plain language
secondaryActivities	object[]	Secondary activities, each { code, description }

Address & Contact

Field	Type	Description
street	string	Street type and name
number	string	Street number
complement	string	Address complement
neighborhood	string	Neighborhood (bairro)
city	string	City (município)
state	string	State (UF)
zipCode	string	Postal code (CEP)
country	string	Country
phone1	string	Primary phone (with area code)
phone2	string	Secondary phone
fax	string	Fax number
email	string	Registered email

Tax Profile

Field	Type	Description
simplesNacional	boolean	Enrolled in Simples Nacional
simplesNacionalOptIn	string	Simples Nacional opt-in date
simplesNacionalOptOut	string	Simples Nacional opt-out date
mei	boolean	Registered as MEI (micro-entrepreneur)
meiOptIn	string	MEI opt-in date
meiOptOut	string	MEI opt-out date
taxRegimes	object[]	Tax-regime history, each { year, taxation }
federativeEntity	string	Responsible federative entity (for public bodies)

Partners & Source

Field	Type	Description
partners	object[]	Partner list (QSA), each { name, role, since, maskedId, ageRange }
partnerCount	number	Number of partners on the record
sourceUrl	string	Official registry URL for the record

Tips for Best Results

• Have CNPJs? Paste them directly. Direct lookups have no volume cap and always return the full record, so a CNPJ list is the fastest, most complete path for enrichment, KYC, and due-diligence workflows.
• Discovery returns a curated sample — combine filters to go deeper. The public company directory returns up to about 20 companies per filter combination. To reach more companies, stack several filters (state + activity + city + legal form) to run many precise searches instead of one broad one, then feed the CNPJs you collect back in through cnpjs for full records.
• Don't bother cleaning your CNPJs. Mixed formats in the same list work fine — 11.222.333/0001-81 and 11222333000181 are treated identically, so you can paste straight from a spreadsheet.
• Use status: ATIVA to skip dead entities. Filtering to active registrations avoids closed (BAIXADA) and suspended companies when you only want operating businesses.
• CNAE codes match primary and secondary activities. A single activityCode catches companies that list your target activity anywhere in their profile, not just as their main line of business.
• Check establishmentType before you contact. MATRIZ is the head office and FILIAL is a branch — route correspondence and contracts to the right one.
• Start small, then scale. Run a handful of CNPJs first to confirm the fields you need are populated, then submit your full list.

Pricing

From $0.99 per 1,000 results — a flat rate per company record, whichever tier you're on. Bronze, Silver, and Gold subscribers pay progressively less; the table below shows total cost at each discount tier.

Results	No discount	Bronze	Silver	Gold
100	$0.12	$0.11	$0.11	$0.10
1,000	$1.15	$1.10	$1.05	$0.99
10,000	$11.50	$11.00	$10.50	$9.90
100,000	$115.00	$110.00	$105.00	$99.00

No compute or time-based charges — you pay per result, plus a small fixed per-run start fee. A "result" is any company row in the output dataset.

Integrations

Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via:

• Zapier / Make / n8n — Workflow automation
• Google Sheets — Direct spreadsheet export
• Slack / Email — Notifications on new results
• Webhooks — Trigger custom APIs on run completion
• Apify API — Full programmatic access

Legal & Ethical Use

This actor collects publicly available company registry data published by Brazil's federal tax authority (Receita Federal). Use it for legitimate purposes such as lead generation, compliance, due diligence, and market research. You are responsible for using the data lawfully, including compliance with Brazil's data protection law (LGPD) and any applicable terms of use. Do not use the data for spam, harassment, or any unlawful activity.