OrbTop

Brazil CNPJ Receita Federal Scraper

BUSINESSLEAD GENERATIONAUTOMATION
Try on Apify

Brazil CNPJ Receita Federal Scraper

Scrape Brazilian companies (CNPJ) from Receita Federal's open registry via minhareceita.org, the community mirror that refreshes monthly from the government bulk dumps. Returns the full company record — legal name, trade name, address, partners (QSA), CNAE industry codes, tax-regime flags, and registration status — across all 55M+ active CNPJs.

Brazil CNPJ Receita Federal Scraper Features

  • Looks up a single CNPJ or paginates the registry by filter.
  • Filters by state (UF), CNAE industry code, IBGE municipality, legal form, or partner CPF — alone or combined.
  • Returns 40+ fields per company, including the QSA partner list and tax-regime flags most enrichment APIs gate behind a paywall.
  • Flags MEI (micro-entrepreneur), Simples Nacional, and public-sector entities so you can segment the file before it leaves the run.
  • Pure JSON API — no browser, no proxy, no captcha. Hard to break.
  • Uses the upstream cursor pagination directly, so it does not skip records the way offset-based scrapers do once you cross the 10k mark.

Who Uses Brazil CNPJ Data?

  • B2B prospecting teams — Pull every company in a CNAE + state combo, drop it into a CRM, and stop buying lead lists.
  • Fintechs and KYC providers — Verify a customer's CNPJ against the registry and capture the partner network for AML screening.
  • Tax consultancies — Filter by Simples Nacional opt-ins or specific tax regimes to find the firms whose books you actually want.
  • Trade-credit insurers — Pre-fill underwriting workflows with status, capital, opening date, and partner data without paying per-call enrichment fees.
  • Researchers and journalists — Map ownership chains by partner CPF — Receita already masks the CPFs (***123456**), so the field is safe to surface.

How Brazil CNPJ Receita Federal Scraper Works

  1. Pick a mode. Either supply one CNPJ for a direct lookup, or set at least one filter (UF, CNAE, municipality, legal form, or partner CPF) for a bulk crawl.
  2. The scraper hits minhareceita.org. For bulk runs it walks the cursor-paginated search until it has maxItems records or the cursor runs out.
  3. Each upstream record is flattened into the dataset schema below. Nested objects become formatted strings; arrays of objects become lists of human-readable strings; CPFs stay masked.
  4. Results stream into the Apify dataset. Stop the run any time — the records already in the dataset are yours.

Input

{
  "uf": "SP",
  "cnae": "6209100",
  "pageSize": 100,
  "maxItems": 1000
}
Field Type Default Description
cnpj string "" A single 14-digit CNPJ (dots, slashes, dashes ignored). Overrides every search filter.
uf string "DF" Two-letter Brazilian state code (SP, RJ, DF…). Set to empty for any state.
cnae string "" CNAE code (matches both primary and secondary activities). Example: 6209100 (IT support).
municipio string "" IBGE or SIAFI municipal code, digits only. Example: 5300108 (Brasília).
naturezaJuridica string "" Legal-form code. Example: 2135 (Empresário Individual).
partnerCpf string "" Partner CPF/CNPJ in the masked Receita format (***123456** for CPF). Use this to find every company an individual sits on.
pageSize integer 100 Records per upstream API page (1–1000). Larger pages are faster but use more memory.
maxItems integer 50 Maximum records the run will save across all queries.

Bulk-search mode requires at least one of uf, cnae, municipio, naturezaJuridica, or partnerCpf. The upstream API times out on no-filter queries — the scraper rejects them up front so you do not pay for a dead run.

Single-CNPJ lookup

{
  "cnpj": "00.000.000/0001-91",
  "maxItems": 1
}

Find every IT support company in São Paulo

{
  "uf": "SP",
  "cnae": "6209100",
  "maxItems": 5000
}

Pull every MEI in a city

{
  "municipio": "5300108",
  "naturezaJuridica": "2135",
  "maxItems": 1000
}

Brazil CNPJ Receita Federal Scraper Output Fields

{
  "cnpj": "00000000000191",
  "razao_social": "BANCO DO BRASIL SA",
  "nome_fantasia": "DIRECAO GERAL",
  "matriz_filial": "MATRIZ",
  "situacao_cadastral": "ATIVA",
  "situacao_cadastral_motivo": "SEM MOTIVO",
  "data_situacao_cadastral": "2005-11-03",
  "data_abertura": "1966-08-01",
  "cnae_principal_codigo": "6422100",
  "cnae_principal_descricao": "Bancos múltiplos, com carteira comercial",
  "cnaes_secundarios": ["6499999 — Outras atividades de serviços financeiros"],
  "natureza_juridica_codigo": "2038",
  "natureza_juridica": "Sociedade de Economia Mista",
  "porte": "DEMAIS",
  "capital_social": 120000000000,
  "logradouro": "QUADRA SAUN QUADRA 5 BLOCO B TORRE I, II, III",
  "numero": "SN",
  "complemento": "ANDAR T I SL S101 A S1602",
  "bairro": "ASA NORTE",
  "municipio": "BRASILIA",
  "uf": "DF",
  "cep": "70040912",
  "pais": "",
  "telefone1": "6134939002",
  "telefone2": "",
  "fax": "6134931040",
  "email": "secex@bb.com.br",
  "simples_nacional": false,
  "data_opcao_simples": "2007-07-01",
  "data_exclusao_simples": "2007-07-01",
  "mei": false,
  "data_opcao_mei": "2009-07-01",
  "data_exclusao_mei": "2009-07-01",
  "regime_tributario": ["LUCRO REAL (2020)", "LUCRO REAL (2021)"],
  "ente_federativo": "",
  "orgao_publico": false,
  "qsa": ["TARCIANA PAULA GOMES MEDEIROS — Presidente — id: ***128734** — entry: 2023-01-26"],
  "qsa_count": 42,
  "ultima_atualizacao": "",
  "source_url": "https://minhareceita.org/00000000000191"
}
Field Type Description
cnpj string 14-digit CNPJ — Brazil's company tax/registry ID.
razao_social string Legal name of the company.
nome_fantasia string Trade name (DBA).
matriz_filial string MATRIZ (head office) or FILIAL (branch).
situacao_cadastral string ATIVA, SUSPENSA, INAPTA, BAIXADA, or NULA.
situacao_cadastral_motivo string Reason text for the current status.
data_situacao_cadastral string Date the status took effect (YYYY-MM-DD).
data_abertura string Date the company started operating (YYYY-MM-DD).
cnae_principal_codigo string Primary CNAE industry code.
cnae_principal_descricao string Primary CNAE description.
cnaes_secundarios string[] Secondary CNAE codes formatted as CODE — Description.
natureza_juridica_codigo string Legal-form code.
natureza_juridica string Legal-form description.
porte string Size class: MICRO EMPRESA, EPP, DEMAIS.
capital_social number Declared capital in BRL.
logradouro string Street address line, prefixed with the type (e.g. AVENIDA Brasil).
numero string Street number.
complemento string Suite, floor, room.
bairro string Neighborhood.
municipio string City name.
uf string Two-letter state code.
cep string Postal code (8 digits).
pais string Country (only when registered abroad).
telefone1 string Primary phone (DDD + number, concatenated).
telefone2 string Secondary phone.
fax string Fax number.
email string Contact email reported to Receita Federal.
simples_nacional boolean Opted into Simples Nacional.
data_opcao_simples string Simples Nacional opt-in date.
data_exclusao_simples string Simples Nacional opt-out date.
mei boolean MEI (Micro Empreendedor Individual).
data_opcao_mei string MEI opt-in date.
data_exclusao_mei string MEI opt-out date.
regime_tributario string[] Tax regimes by year (LUCRO REAL (2020), SIMPLES (2021)…).
ente_federativo string Federative entity (only on public-sector CNPJs).
orgao_publico boolean True when the legal-form code identifies a public-sector body.
qsa string[] Partner list. Each entry is NAME — ROLE — id: ***123456** — entry: YYYY-MM-DD. CPFs are pre-masked by Receita Federal.
qsa_count number Number of partners.
ultima_atualizacao string Upstream record's last-updated timestamp (when present).
source_url string Direct upstream URL for the record.

FAQ

How do I scrape Brazilian companies by CNAE and state?

Brazil CNPJ Receita Federal Scraper takes a uf plus a cnae and walks every match through the registry. A São Paulo IT-support sweep is { "uf": "SP", "cnae": "6209100" }. The cursor pagination handles the rest.

Does Brazil CNPJ Receita Federal Scraper need proxies?

No. The data sits behind Cloudflare CDN with caching enabled, so plain HTTP requests work fine. No proxy, no captcha, no anti-bot to dodge.

How current is the Receita Federal data?

The upstream mirror reloads from Receita Federal's monthly bulk dumps, so most records are 0–45 days behind the official source. Active/baixada status flips and partner changes show up on the next refresh — not the same day, but better than the Receita website which itself is on the same cycle.

Can I look up a single CNPJ instead of running a bulk crawl?

Yes. Set the cnpj field to a 14-digit CNPJ (formatting is stripped) and ignore everything else. The actor returns one record and exits. Useful for KYC enrichment.

What about the partner CPFs — is that legal to surface?

Receita Federal already publishes the QSA with masked CPFs in the format ***123456**. The scraper passes those through as-is — you never see a complete unmasked CPF, so there is nothing to redact downstream.

How much does a typical run cost?

The actor uses standard PPE pricing: $0.10 per run start plus $0.001 per record. A 10,000-record state-wide CNAE sweep is about $10.10. The math is unambitious because the data is.

Need More Features?

Need additional filters, custom fields, or a different Brazilian dataset wired in? File an issue or get in touch.

Why Use Brazil CNPJ Receita Federal Scraper?

  • Bulk discovery, not just enrichment — Most CNPJ actors on the market take a known CNPJ and return one record. This one finds the CNPJs in the first place by CNAE, state, city, or legal form.
  • Full registry data — Returns the partner list (QSA), tax-regime history, MEI flag, and Simples Nacional status — fields that competitors typically gate behind premium tiers.
  • Cheap and fast — Pure JSON API, no browser, no proxy. ~$0.001 per record and several hundred records per minute on a single instance.
Try on Apify