BrasilAPI CNPJ Company Scraper

Look up Brazilian company data instantly using the free BrasilAPI CNPJ endpoint. Enter one or more CNPJ numbers and receive official Receita Federal (Brazilian IRS) data — no API key, no login, no cost.

What You Get

• Official company name (razaoSocial) and trade name (nomeFantasia)
• Registration status: Active, Suspended, Void, Closed, Null
• Primary and secondary CNAE industry codes with descriptions
• Full address: street, number, neighbourhood, city, state, postal code
• Contact details: phone, email
• Company size classification (Micro, Small, Other)
• Legal nature (naturezaJuridica) and unit type (Headquarters / Branch)
• Share capital (capitalSocial) in BRL
• Founding date (dataInicioAtividade)
• Tax regime (regimeTributario) — latest year
• Partner/shareholder list (QSA) with name, role, age bracket, and entry date
• Direct source URL for each company record

Input

Parameter	Type	Required	Default	Description
cnpjs	array	Yes	—	List of CNPJ numbers to look up. Accepts any format: 18.236.120/0001-58, 18236120000158, or mixed.
includePartners	boolean	No	true	Include the partner/shareholder list (QSA) in the output.
includeSecondaryActivities	boolean	No	true	Include secondary CNAE activity codes in the output.

Example Input

{
  "cnpjs": ["18.236.120/0001-58", "47960950000121", "33000167000101"],
  "includePartners": true,
  "includeSecondaryActivities": true
}

Output

Each CNPJ lookup produces one dataset record. All fields are omit-empty — only populated fields appear.

Sample Record

{
  "cnpj": "18236120000158",
  "razaoSocial": "MAGAZINE LUIZA S.A.",
  "nomeFantasia": "MAGAZINE LUIZA",
  "situacaoCadastralCodigo": 2,
  "situacaoCadastral": "Ativa",
  "dataSituacaoCadastral": "2018-01-01",
  "porteCodigo": 5,
  "porte": "Demais",
  "tipoUnidade": "Matriz",
  "naturezaJuridica": "2046 - Sociedade Anônima Aberta",
  "cnaeFiscal": 4752100,
  "cnaeDescricao": "Comércio varejista especializado de equipamentos e suprimentos de informática",
  "cnaesSecundarios": [
    { "codigo": 4731800, "descricao": "Comércio varejista de combustíveis para veículos automotores" }
  ],
  "endereco": {
    "logradouro": "Avenida Franca",
    "numero": "1234",
    "bairro": "Centro",
    "municipio": "Franca",
    "uf": "SP",
    "cep": "14400000"
  },
  "municipio": "Franca",
  "uf": "SP",
  "cep": "14400000",
  "telefone1": "01632163000",
  "capitalSocial": 9800000000.0,
  "dataInicioAtividade": "1996-01-01",
  "socios": [
    {
      "nome": "LUIZA HELENA TRAJANO INÁCIO RODRIGUES",
      "qualificacao": "Presidente",
      "faixaEtaria": "61 a 70 anos",
      "dataEntradaSociedade": "2009-05-01"
    }
  ],
  "sourceUrl": "https://brasilapi.com.br/api/cnpj/v1/18236120000158"
}

Output Fields Reference

Field	Type	Description
cnpj	string	14-digit CNPJ number
razaoSocial	string	Official corporate name
nomeFantasia	string	Trade/brand name
situacaoCadastralCodigo	integer	Status code (1–8)
situacaoCadastral	string	Status label: Ativa, Suspensa, Inapta, Baixada, Nula
dataSituacaoCadastral	string	Date of last status change (YYYY-MM-DD)
porteCodigo	integer	Size code
porte	string	Size label: Micro Empresa, Empresa de Pequeno Porte, Demais
tipoUnidade	string	Matriz (headquarters) or Filial (branch)
naturezaJuridica	string	Legal nature code and description
cnaeFiscal	integer	Primary CNAE industry code
cnaeDescricao	string	Primary CNAE description
cnaesSecundarios	array	Secondary CNAE codes [{codigo, descricao}]
endereco	object	Full address object
municipio	string	City name (top-level)
uf	string	State abbreviation (e.g., SP, RJ)
cep	string	Postal code
telefone1	string	Primary phone (DDD + number)
telefone2	string	Secondary phone
email	string	Company email address
capitalSocial	number	Share capital in BRL
dataInicioAtividade	string	Founding / activity start date
regimeTributario	string	Tax regime (latest year available)
socios	array	Partner list [{nome, qualificacao, faixaEtaria, dataEntradaSociedade}]
sourceUrl	string	BrasilAPI URL for this record

FAQ

What is a CNPJ? CNPJ (Cadastro Nacional da Pessoa Jurídica) is Brazil's 14-digit national company registration number, issued by the Receita Federal (Brazilian IRS). Every legally registered Brazilian company has one.

Where does the data come from? Data is sourced from BrasilAPI's free CNPJ endpoint, which mirrors the official Receita Federal database. It is updated periodically and reflects the same data you would find on the government's own portal.

Does this require an API key or login? No. BrasilAPI's CNPJ endpoint is completely free and public — no authentication required.

What CNPJ formats are accepted? Any common format: formatted (18.236.120/0001-58), unformatted (18236120000158), or mixed in the same input list.

What happens if a CNPJ is not found or invalid? Invalid CNPJs (not 14 digits after stripping punctuation) are skipped with a logged warning. CNPJs that return 404 from the API (genuinely not found in Receita Federal) are also skipped.

How many CNPJs can I look up per run? There is no hard limit — you can pass as many as needed. The actor adds a short delay between requests to respect BrasilAPI's fair-use policy.

Can I disable the partner list to get smaller records? Yes. Set includePartners to false to omit the socios field. Similarly, set includeSecondaryActivities to false to omit cnaesSecundarios.

What is the QSA / socios field? QSA stands for Quadro Societário de Administração — the official list of company partners and administrators registered with the Receita Federal.

Is this suitable for bulk CNPJ validation? Yes. You can pass thousands of CNPJs in a single run. Records with invalid or non-existent CNPJs are silently skipped, so you only receive valid results.