Brazil CNPJ Receita Federal Scraper

Brazil CNPJ Receita Federal Scraper: companies, partners (QSA), CNAE and tax status from the open registry

Brazil CNPJ Receita Federal Scraper extracts Brazilian companies from the open registry of the Receita Federal and returns them as clean, flat records. Look up one CNPJ, or search in bulk by state (UF), CNAE activity code, município, natureza jurídica or a partner's masked CPF. Each company comes with its razão social, nome fantasia, situação cadastral, address, contact details, sócios (QSA), porte, Simples Nacional and MEI flags and tax regimes.

• Bulk search with filters. Collect every company in a state, industry or city, not just one CNPJ at a time.
• Find companies by partner. Search by a partner's masked CPF (***123456**) to see every company they belong to.
• Complete registry record. More than 40 fields per company, including secondary CNAEs, partners and tax regimes per year.
• No proxies, browser, CAPTCHA or Receita Federal account. Data comes from the public API of minhareceita.org, a community mirror of the official Receita Federal dumps.
• Export anywhere. JSON, CSV, Excel, XML, HTML or the Apify API.

Run it on Apify: Brazil CNPJ Receita Federal Scraper.

A Spanish version of this page follows the English one: Versión en español.

Scope: This actor reads the Brazilian company registry only. For French companies use Pappers.fr Company Scraper, for German company filings use Bundesanzeiger Scraper.

What can you do with it?

Goal	How
B2B lead lists	Filter by uf, cnae and municipio, then use email, telefone1, porte and situacao_cadastral.
KYC and due diligence	Look up a cnpj and check status, capital, opening date and partners (qsa).
Credit and risk analysis	Read situacao_cadastral, capital_social, data_abertura, porte and regime_tributario.
Market sizing	Count companies by CNAE, UF or município, split by MEI, Simples Nacional or porte.
Tax and accounting prospects	Filter on simples_nacional, mei and regime_tributario in the output to find clients.
Journalism and research	Map the companies of a person with partnerCpf.

Quick start

1. Open the actor on Apify and click Try for free.
2. Fill in one filter, for example cnae = 6209100, or enter a single cnpj.
3. Keep Maximum records (maxItems) small for the first run. The default is 50.
4. Click Start, then open the Output tab to view and export the data.

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

Input

There are two modes:

• Single CNPJ lookup. If cnpj is set, it overrides every search filter and the actor returns that one company.
• Bulk search. Otherwise the actor pages through all companies matching your filters. At least one filter is required (uf, cnae, municipio, naturezaJuridica or partnerCpf), or the run fails with an error. Filters are combined (AND).

Field	Type	Default	Effect
cnpj	String	Empty	One 14-digit CNPJ. Dots, slashes and dashes are ignored (00.000.000/0001-91 works). Overrides all filters.
uf	String	"DF"	Two-letter state code (SP, RJ, DF...). Defaults to DF. Set it to "" to search all states.
cnae	String	Empty	CNAE code. Matches both primary and secondary activities. Example: 6209100.
municipio	String	Empty	Municipality code (IBGE or SIAFI), digits only. Example: 5300108 (Brasília). This is a code, not a name.
naturezaJuridica	String	Empty	Legal-form code. Example: 2135 (Empresário Individual).
partnerCpf	String	Empty	Partner's CPF in the Receita's masked format (***123456**). Finds every company where that partner appears.
pageSize	Integer	100	Records per request to the source API, from 1 to 1000.
maxItems	Integer	50	Maximum records saved per run, from 1 to 100000. Free-plan accounts have a monthly cap (see Limits).

Important: uf is pre-filled with DF (Distrito Federal). If you search by cnae and expect the whole country, you get only companies in DF. To search nationwide, set "uf": "" and keep at least one other filter:

{
    "uf": "",
    "cnae": "6209100",
    "maxItems": 1000
}

With "uf": "" and no other filter the run stops with an error, because bulk search needs at least one filter.

Ready-to-run examples

Look up one CNPJ

{
    "cnpj": "00.000.000/0001-91"
}

IT companies in São Paulo

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

Individual entrepreneurs (Empresário Individual) in Brasília

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

Leave uf at DF here, or set it to "". A município code is already specific to one state.

All companies of a partner

{
    "uf": "",
    "partnerCpf": "***123456**",
    "maxItems": 200
}

The masked CPF has six visible digits, so different people can share it. Check the returned qsa entries before drawing conclusions.

What data do you get?

Each row is one company, with these fields. Text fields that are missing upstream are returned as an empty string "", not null.

Group	Fields
Identity	cnpj, razao_social, nome_fantasia, matriz_filial
Status	situacao_cadastral, situacao_cadastral_motivo, data_situacao_cadastral, data_abertura
Activity	cnae_principal_codigo, cnae_principal_descricao, cnaes_secundarios
Legal and size	natureza_juridica_codigo, natureza_juridica, porte, capital_social
Address	logradouro, numero, complemento, bairro, municipio, uf, cep, pais
Contact	telefone1, telefone2, fax, email
Tax	simples_nacional, data_opcao_simples, data_exclusao_simples, mei, data_opcao_mei, data_exclusao_mei, regime_tributario
Public sector	ente_federativo, orgao_publico
Partners	qsa, qsa_count
Metadata	ultima_atualizacao, source_url

Field reference

Field	Type	Description
cnpj	string	14-digit CNPJ, digits only.
razao_social	string	Legal name.
nome_fantasia	string	Trade name.
matriz_filial	string	MATRIZ (head office) or FILIAL (branch).
situacao_cadastral	string	Registration status: ATIVA, SUSPENSA, INAPTA, BAIXADA or NULA.
situacao_cadastral_motivo	string	Reason for the current status.
data_situacao_cadastral	string	Date the status took effect (YYYY-MM-DD).
data_abertura	string	Start-of-activity date (YYYY-MM-DD).
cnae_principal_codigo	string	Primary CNAE code.
cnae_principal_descricao	string	Primary CNAE description.
cnaes_secundarios	array of strings	Secondary CNAEs as CODE — Description.
natureza_juridica_codigo	string	Legal-form code.
natureza_juridica	string	Legal-form description.
porte	string	Size class, such as MICRO EMPRESA, EPP or DEMAIS.
capital_social	number	Declared share capital in BRL. 0 if missing.
logradouro	string	Street.
numero	string	Street number.
complemento	string	Suite or room.
bairro	string	Neighborhood.
municipio	string	Município name (the input filter takes a code, the output has the name).
uf	string	Two-letter state code.
cep	string	8-digit postal code.
pais	string	Country, only when the company is registered abroad.
telefone1	string	Main phone, area code and number joined (DDD + number).
telefone2	string	Secondary phone.
fax	string	Fax number.
email	string	Email reported to the Receita Federal.
simples_nacional	boolean	Currently opted in to Simples Nacional.
data_opcao_simples	string	Date of opting in to Simples Nacional.
data_exclusao_simples	string	Date of exclusion from Simples Nacional.
mei	boolean	Currently a MEI (Microempreendedor Individual).
data_opcao_mei	string	Date of opting in to MEI.
data_exclusao_mei	string	Date of exclusion from MEI.
regime_tributario	array of objects	Tax regime by year: ano, forma_de_tributacao, quantidade_de_escrituracoes, cnpj_da_scp. Passed through from the source as is.
ente_federativo	string	Responsible federative entity, only for public-sector CNPJs.
orgao_publico	boolean	true when the legal-form code starts with 1 (public administration).
qsa	array of strings	Partners, each as NAME — ROLE — id: ***123456** — entry: YYYY-MM-DD.
qsa_count	integer	Number of partners.
ultima_atualizacao	string	Reserved field. It is currently always an empty string.
source_url	string	Direct link to the record on minhareceita.org.

Output

Results go to the run's default dataset. The Resumen view shows cnpj, razao_social, situacao_cadastral, uf, municipio and cnae_principal_codigo. Export everything as JSON, CSV, Excel, XML or HTML.

This is a real record for 00.000.000/0001-91 (Banco do Brasil), fetched in October 2026, with cnaes_secundarios, regime_tributario and qsa shortened:

{
    "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 não especificadas anteriormente"],
    "natureza_juridica_codigo": "2038",
    "natureza_juridica": "Sociedade de Economia Mista",
    "porte": "DEMAIS",
    "capital_social": 120000000000,
    "logradouro": "SAUN QUADRA 5 BLOCO B TORRE I, II, III",
    "numero": "SN",
    "bairro": "ASA NORTE",
    "municipio": "BRASILIA",
    "uf": "DF",
    "cep": "70040912",
    "pais": "",
    "telefone1": "6134939002",
    "fax": "6134931040",
    "email": "",
    "simples_nacional": false,
    "mei": false,
    "regime_tributario": [
        {
            "ano": 2016,
            "cnpj_da_scp": null,
            "forma_de_tributacao": "LUCRO REAL",
            "quantidade_de_escrituracoes": 1
        }
    ],
    "ente_federativo": "",
    "orgao_publico": false,
    "qsa": ["ALAN CARLOS GUEDES DE OLIVEIRA — Diretor — id: ***550179** — entry: 2023-05-17"],
    "qsa_count": 41,
    "ultima_atualizacao": "",
    "source_url": "https://minhareceita.org/00000000000191"
}

Some fields in the full record (complemento, telefone2, the Simples and MEI dates) are omitted above for length. Note that the Simples and MEI dates can be filled even when the current flag is false: they are historical dates from the registry.

Track the registry over time with scheduled runs

Company records change: a company closes, a partner leaves, a tax regime switches. Run the same search again and compare. Apify can run the actor for you on a schedule and send the results wherever you need them.

1. Save your input as a task

Open the actor, set your filters (for example cnae and uf), then click Save as a new task. A task is a saved input you can run again with one click or on a schedule.

2. Schedule the task

In Apify Console, go to Schedules, click Create new, choose how often to run (for example monthly on the 5th at 06:00 in your time zone), and add your task. See Schedules and How to create a schedule.

Watch how to schedule an Actor:

Or schedule a saved task:

Common schedules:

Use case	Frequency	Cron expression
Monitor situacao_cadastral of known CNPJs	Weekly (Monday)	0 6 * * 1
New companies in a CNAE and state	Monthly	0 6 5 * *
Partner (qsa) change alerts	Monthly	0 6 5 * *
Quarterly lead list refresh	Every 3 months	0 6 1 */3 *

The source is reloaded roughly once a month, so running more often than weekly rarely finds changes.

3. Send the results to a spreadsheet

Connect Google in the task's Integrations tab to save every run to Google Sheets or Google Drive automatically:

4. Compare runs

Every row has cnpj as a stable key, so runs are easy to join:

• Status changes: situacao_cadastral and data_situacao_cadastral per cnpj (for example ATIVA to BAIXADA).
• New companies: cnpjs that appear for the first time, with their data_abertura.
• Partner changes: qsa and qsa_count per cnpj.
• Tax regime moves: simples_nacional and mei flags per cnpj.
• Capital and size: capital_social and porte over time.

Use it through the API

You can start the actor from your own code with the Apify API. Replace YOUR_API_TOKEN with your token from Apify Console.

curl -X POST "https://api.apify.com/v2/acts/epicscrapers~brazil-cnpj-scraper/run-sync-get-dataset-items?token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"uf": "SP", "cnae": "6209100", "maxItems": 100}'

Python:

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")
run = client.actor("epicscrapers/brazil-cnpj-scraper").call(
    run_input={"cnpj": "00.000.000/0001-91"}
)
for company in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(company["razao_social"], company["situacao_cadastral"])

JavaScript:

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });
const run = await client.actor('epicscrapers/brazil-cnpj-scraper').call({
    uf: 'SP',
    cnae: '6209100',
    maxItems: 100,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();

Use Apify schedules to re-run a search monthly, and integrations such as Make, Zapier, n8n or Google Sheets to send results on.

Limits and pricing

• Free plan: free accounts can collect up to 10,000 records per calendar month (UTC), counted across all runs. The counter resets at 00:00 UTC on the first day of the month. When the allowance is used up, the actor saves one extra row whose razao_social and message explain that the free limit was reached, then stops. That notice row is also saved when a free run asks for more than 10,000 maxItems and reaches the cap.
• Paid accounts: no monthly cap. Each run can save up to 100000 records (the maxItems maximum).
• Price: see the Pricing tab of the actor page for the current price. It is always up to date there.
• Data freshness: the source is a mirror that is reloaded from the official Receita Federal dumps roughly once a month, so a record can be some weeks old.

FAQ

Why do I only get companies from Distrito Federal?

uf defaults to DF. Clear it ("uf": "") and add another filter such as cnae to search all of Brazil.

Why did my run fail with "requires at least one filter"?

Bulk search needs at least one of uf, cnae, municipio, naturezaJuridica or partnerCpf. With "uf": "" and nothing else there is nothing to search on. Add a filter, or use cnpj for a single company.

Can I search by company name?

No. The actor supports the filters in the input table only. To find a company by name, look up its CNPJ first.

Can I search by partner?

Yes. Use partnerCpf with the masked CPF as the Receita Federal publishes it (***123456**). The actor passes it through unchanged. Partner names appear in the qsa field.

Are full CPFs available?

No. The Receita Federal publishes partner CPFs masked, and so does this actor.

What is the municipio filter?

A numeric municipality code (IBGE or SIAFI), for example 5300108 for Brasília. The municipio output field is the name of the city.

How fresh is the data?

It follows the monthly update of the minhareceita.org mirror, based on the official Receita Federal dumps. For a current status, check the date in the registry itself.

Do I need proxies or an account?

No. The actor calls the public minhareceita.org API directly.

What happens if a CNPJ does not exist?

For a single lookup that returns "not found" (HTTP 404), the actor logs a warning and the dataset stays empty.

Is it legal?

The data is public open data from the Receita Federal. You are responsible for how you use it, including compliance with Brazil's LGPD and anti-spam rules when contacting companies or people.

Related Actors

• Pappers.fr Company Scraper: French company registry (SIREN, directors, finances).
• Bundesanzeiger Scraper: German company filings and annual accounts.
• eBay Business Leads Scraper: business seller leads from eBay.

Support

Report problems or request features in the Issues tab of the actor page. Include the run ID and your input. This actor is not affiliated with or endorsed by the Receita Federal or minhareceita.org.

---

Versión en español

Extractor de CNPJ Brasil: empresas, socios (QSA), CNAE y situación tributaria del registro abierto de la Receita Federal

Este actor extrae empresas brasileñas del registro abierto de la Receita Federal y las devuelve como registros planos y limpios. Consulta un solo CNPJ o busca de forma masiva por estado (UF), código CNAE, municipio, naturaleza jurídica o CPF enmascarado de un socio. Cada empresa trae su razão social, nome fantasia, situação cadastral, dirección, contacto, socios (QSA), porte, banderas de Simples Nacional y MEI y regímenes tributarios.

• Búsqueda masiva con filtros. Obtén todas las empresas de un estado, sector o ciudad, no solo un CNPJ a la vez.
• Empresas por socio. Busca por el CPF enmascarado de un socio (***123456**) para ver todas las empresas en las que participa.
• Registro completo. Más de 40 campos por empresa, incluidos CNAE secundarios, socios y regímenes tributarios por año.
• Sin proxies, navegador, CAPTCHA ni cuenta de la Receita Federal. Los datos vienen de la API pública de minhareceita.org, un mirror comunitario de los volcados oficiales de la Receita Federal.
• Exporta donde quieras. JSON, CSV, Excel, XML, HTML o la API de Apify.

Ejecútalo en Apify: Brazil CNPJ Receita Federal Scraper.

Alcance: este actor solo lee el registro de empresas de Brasil. Para empresas francesas usa Pappers.fr Company Scraper y para cuentas y publicaciones alemanas usa Bundesanzeiger Scraper.

¿Qué puedes hacer con él?

Objetivo	Cómo
Listas de leads B2B	Filtra por uf, cnae y municipio, y usa email, telefone1, porte y situacao_cadastral.
KYC y due diligence	Consulta un cnpj y revisa estado, capital, fecha de apertura y socios (qsa).
Análisis de crédito y riesgo	Lee situacao_cadastral, capital_social, data_abertura, porte y regime_tributario.
Dimensionamiento de mercado	Cuenta empresas por CNAE, UF o municipio, separadas por MEI, Simples Nacional o porte.
Prospectos contables y fiscales	Filtra en la salida por simples_nacional, mei y regime_tributario para encontrar clientes.
Periodismo e investigación	Mapea las empresas de una persona con partnerCpf.

Inicio rápido

1. Abre el actor en Apify y haz clic en Try for free.
2. Completa un filtro, por ejemplo cnae = 6209100, o escribe un solo cnpj.
3. Deja Máximo de Registros (maxItems) bajo en la primera ejecución. El valor por defecto es 50.
4. Haz clic en Start y abre la pestaña Output para ver y exportar los datos.

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

Entrada

Hay dos modos:

• Consulta de un CNPJ. Si cnpj tiene valor, anula todos los filtros y el actor devuelve esa empresa.
• Búsqueda masiva. En caso contrario recorre todas las empresas que cumplen tus filtros. Se requiere al menos un filtro (uf, cnae, municipio, naturezaJuridica o partnerCpf); si no, la ejecución falla con un error. Los filtros se combinan (AND).

Campo	Tipo	Valor por defecto	Efecto
cnpj	String	Vacío	Un CNPJ de 14 dígitos. Se ignoran puntos, barras y guiones (00.000.000/0001-91 funciona). Anula los filtros.
uf	String	"DF"	Código de estado de dos letras (SP, RJ, DF...). Por defecto es DF. Usa "" para buscar en todos.
cnae	String	Vacío	Código CNAE. Coincide con actividades principales y secundarias. Ejemplo: 6209100.
municipio	String	Vacío	Código de municipio (IBGE o SIAFI), solo dígitos. Ejemplo: 5300108 (Brasília). Es un código, no un nombre.
naturezaJuridica	String	Vacío	Código de naturaleza jurídica. Ejemplo: 2135 (Empresário Individual).
partnerCpf	String	Vacío	CPF del socio en el formato enmascarado de la Receita (***123456**). Encuentra las empresas donde aparece.
pageSize	Integer	100	Registros por solicitud a la API de origen, de 1 a 1000.
maxItems	Integer	50	Máximo de registros guardados por ejecución, de 1 a 100000. El plan gratuito tiene un tope mensual (ver Límites).

Importante: uf viene rellenado con DF (Distrito Federal). Si buscas por cnae esperando todo el país, obtendrás solo empresas de DF. Para buscar a nivel nacional usa "uf": "" y mantén al menos otro filtro:

{
    "uf": "",
    "cnae": "6209100",
    "maxItems": 1000
}

Con "uf": "" y ningún otro filtro, la ejecución se detiene con un error, porque la búsqueda masiva necesita al menos un filtro.

Ejemplos listos para usar

Consultar un CNPJ

{
    "cnpj": "00.000.000/0001-91"
}

Empresas de TI en São Paulo

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

Empresarios individuales (Empresário Individual) en Brasília

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

Deja uf en DF o ponlo en "". Un código de municipio ya pertenece a un solo estado.

Todas las empresas de un socio

{
    "uf": "",
    "partnerCpf": "***123456**",
    "maxItems": 200
}

El CPF enmascarado muestra solo seis dígitos, así que personas distintas pueden coincidir. Revisa las entradas de qsa antes de sacar conclusiones.

¿Qué datos obtienes?

Cada fila es una empresa. Los campos de texto que faltan en el origen se devuelven como cadena vacía "", no como null.

Grupo	Campos
Identidad	cnpj, razao_social, nome_fantasia, matriz_filial
Situación	situacao_cadastral, situacao_cadastral_motivo, data_situacao_cadastral, data_abertura
Actividad	cnae_principal_codigo, cnae_principal_descricao, cnaes_secundarios
Jurídico y tamaño	natureza_juridica_codigo, natureza_juridica, porte, capital_social
Dirección	logradouro, numero, complemento, bairro, municipio, uf, cep, pais
Contacto	telefone1, telefone2, fax, email
Tributario	simples_nacional, data_opcao_simples, data_exclusao_simples, mei, data_opcao_mei, data_exclusao_mei, regime_tributario
Sector público	ente_federativo, orgao_publico
Socios	qsa, qsa_count
Metadatos	ultima_atualizacao, source_url

Referencia de campos

Campo	Tipo	Descripción
cnpj	string	CNPJ de 14 dígitos, solo números.
razao_social	string	Razón social (nombre legal).
nome_fantasia	string	Nombre fantasía (nombre comercial).
matriz_filial	string	MATRIZ (casa matriz) o FILIAL (sucursal).
situacao_cadastral	string	Situación cadastral: ATIVA, SUSPENSA, INAPTA, BAIXADA o NULA.
situacao_cadastral_motivo	string	Motivo de la situación actual.
data_situacao_cadastral	string	Fecha en que entró en vigor la situación (AAAA-MM-DD).
data_abertura	string	Fecha de inicio de actividades (AAAA-MM-DD).
cnae_principal_codigo	string	Código CNAE principal.
cnae_principal_descricao	string	Descripción del CNAE principal.
cnaes_secundarios	array de strings	CNAE secundarios con formato CÓDIGO — Descripción.
natureza_juridica_codigo	string	Código de naturaleza jurídica.
natureza_juridica	string	Descripción de la naturaleza jurídica.
porte	string	Clase de tamaño, por ejemplo MICRO EMPRESA, EPP o DEMAIS.
capital_social	number	Capital social declarado en BRL. 0 si falta.
logradouro	string	Calle.
numero	string	Número.
complemento	string	Oficina, piso o sala.
bairro	string	Barrio.
municipio	string	Nombre del município (el filtro de entrada usa un código, la salida trae el nombre).
uf	string	Código de estado de dos letras.
cep	string	Código postal de 8 dígitos.
pais	string	País, solo cuando la empresa está registrada en el extranjero.
telefone1	string	Teléfono principal, DDD y número juntos.
telefone2	string	Teléfono secundario.
fax	string	Número de fax.
email	string	Correo electrónico informado a la Receita Federal.
simples_nacional	boolean	Adherido actualmente al Simples Nacional.
data_opcao_simples	string	Fecha de adhesión al Simples Nacional.
data_exclusao_simples	string	Fecha de exclusión del Simples Nacional.
mei	boolean	Es MEI (Microempreendedor Individual) actualmente.
data_opcao_mei	string	Fecha de adhesión al MEI.
data_exclusao_mei	string	Fecha de exclusión del MEI.
regime_tributario	array de objetos	Régimen tributario por año: ano, forma_de_tributacao, quantidade_de_escrituracoes, cnpj_da_scp. Se entrega tal como viene del origen.
ente_federativo	string	Ente federativo responsable, solo en CNPJ del sector público.
orgao_publico	boolean	true cuando el código de naturaleza jurídica empieza por 1 (administración pública).
qsa	array de strings	Socios, cada uno como NOMBRE — CARGO — id: ***123456** — entry: AAAA-MM-DD.
qsa_count	integer	Cantidad de socios.
ultima_atualizacao	string	Campo reservado. Actualmente siempre es una cadena vacía.
source_url	string	Enlace directo al registro en minhareceita.org.

Salida

Los resultados van al dataset por defecto de la ejecución. La vista Resumen muestra cnpj, razao_social, situacao_cadastral, uf, municipio y cnae_principal_codigo. Exporta todo como JSON, CSV, Excel, XML o HTML.

El ejemplo real de arriba (Banco do Brasil, CNPJ 00.000.000/0001-91) muestra la forma exacta de cada fila. Algunos campos (complemento, telefone2 y las fechas de Simples y MEI) se omitieron por brevedad. Las fechas de Simples y MEI pueden venir rellenas aunque la bandera actual sea false: son fechas históricas del registro.

Seguimiento con ejecuciones programadas

Los registros cambian: una empresa cierra, un socio sale, cambia el régimen tributario. Guarda tu entrada como tarea (Save as a new task), prográmala en Schedules (por ejemplo, mensual el día 5 a las 06:00, cron 0 6 5 * *) y envía los resultados a Google Sheets desde la pestaña Integrations. La fuente se recarga cerca de una vez al mes, así que ejecutar con más frecuencia que semanal rara vez encuentra cambios. Compara ejecuciones usando cnpj como clave: situacao_cadastral, qsa, qsa_count, simples_nacional y mei.

Uso con la API

Puedes lanzar el actor desde tu propio código con la API de Apify. Reemplaza YOUR_API_TOKEN por tu token de Apify Console. Los ejemplos de cURL, Python y JavaScript de la sección en inglés funcionan igual; solo cambia la entrada, por ejemplo:

curl -X POST "https://api.apify.com/v2/acts/epicscrapers~brazil-cnpj-scraper/run-sync-get-dataset-items?token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"uf": "", "cnae": "6209100", "maxItems": 500}'

Usa las programaciones de Apify para repetir una búsqueda cada mes, e integraciones como Make, Zapier, n8n o Google Sheets para enviar los resultados.

Límites y precio

• Plan gratuito: las cuentas gratuitas pueden extraer hasta 10.000 registros por mes natural (UTC), sumados entre todas sus ejecuciones. El contador se reinicia a las 00:00 UTC del primer día del mes. Cuando se agota el cupo, el actor guarda una fila adicional cuyos campos razao_social y message explican que se alcanzó el límite gratuito, y se detiene. Esa fila de aviso también se guarda cuando una ejecución gratuita pide más de 10.000 en maxItems y llega al tope.
• Cuentas de pago: sin tope mensual. Cada ejecución puede guardar hasta 100000 registros (el máximo de maxItems).
• Precio: consulta la pestaña Pricing de la página del actor para ver el precio vigente.
• Actualización de los datos: la fuente es un mirror que se recarga desde los volcados oficiales de la Receita Federal aproximadamente una vez al mes, así que un registro puede tener algunas semanas de antigüedad.

Preguntas frecuentes

¿Por qué solo obtengo empresas del Distrito Federal?

uf tiene DF por defecto. Bórralo ("uf": "") y añade otro filtro, como cnae, para buscar en todo Brasil.

¿Por qué falló mi ejecución pidiendo al menos un filtro?

La búsqueda masiva necesita al menos uno de uf, cnae, municipio, naturezaJuridica o partnerCpf. Con "uf": "" y nada más no hay criterio de búsqueda. Añade un filtro o usa cnpj para una sola empresa.

¿Puedo buscar por nombre de empresa?

No. El actor solo admite los filtros de la tabla de entrada. Para encontrar una empresa por nombre, primero averigua su CNPJ.

¿Puedo buscar por socio?

Sí. Usa partnerCpf con el CPF enmascarado tal como lo publica la Receita Federal (***123456**). El actor lo pasa sin modificarlo. Los nombres de los socios aparecen en el campo qsa.

¿Hay CPF completos?

No. La Receita Federal publica los CPF de los socios enmascarados, y este actor también.

¿Qué es el filtro municipio?

Un código numérico de municipio (IBGE o SIAFI), por ejemplo 5300108 para Brasília. El campo de salida municipio es el nombre de la ciudad.

¿Qué tan actuales son los datos?

Siguen la actualización mensual del mirror minhareceita.org, basado en los volcados oficiales de la Receita Federal. Para conocer el estado vigente, consulta el registro oficial.

¿Necesito proxies o una cuenta?

No. El actor llama directamente a la API pública de minhareceita.org.

¿Qué pasa si el CNPJ no existe?

En una consulta única que devuelve "no encontrado" (HTTP 404), el actor registra una advertencia y el dataset queda vacío.

¿Es legal?

Los datos son datos abiertos públicos de la Receita Federal. Eres responsable del uso que les des, incluido el cumplimiento de la LGPD y de las normas contra el spam de Brasil al contactar empresas o personas.

Actores relacionados

• Pappers.fr Company Scraper: registro de empresas de Francia.
• Bundesanzeiger Scraper: publicaciones de empresas de Alemania.
• eBay Business Leads Scraper: leads de vendedores profesionales de eBay.

Soporte

Reporta problemas o solicita funciones en la pestaña Issues de la página del actor. Incluye el ID de la ejecución y tu entrada. Este actor no está afiliado ni respaldado por la Receita Federal ni por minhareceita.org.