Brazil Cnpj Company Lookup

Brazil CNPJ Company Lookup — Brazilian Company Partner (QSA) Data

Look up Brazilian company partner (QSA) information using 14-digit CNPJs. Provide a list of company identifiers, set a result limit, and collect partner names, roles, age ranges, entry dates, and related company details in a structured dataset.

Overview

Brazil CNPJ Company Lookup collects partner and shareholder information associated with Brazilian company registration numbers (CNPJ).

Enter one or more CNPJs to retrieve available company partner records. Each partner is saved as an individual dataset row, with the parent company's CNPJ included for easy identification.

Features

• CNPJ lookup: Collect partner information using 14-digit Brazilian company identifiers.
• Partner details: Retrieve names, roles, age ranges, and company entry dates when available.
• Duplicate handling: Removes duplicate CNPJs from the input before processing.
• Result limits: Control the maximum number of partner records collected.
• Structured output: Store results in a clean, spreadsheet-friendly format.
• Multiple exports: Export datasets as JSON, CSV, Excel, and other supported formats.

Use Cases

• Lead enrichment: Add company partner names and roles to Brazilian business lists.
• Business research: Review partner qualifications, age ranges, and entry dates.
• Compliance workflows: Support company ownership and partner information reviews during vendor onboarding.
• CRM management: Enrich and update company records with available partner details.
• Data analysis: Compare partner information across multiple Brazilian companies.

Input Parameters

Parameter	Type	Description
mode	String	Lookup mode. Use cnpj.
cnpjs	Array	List of 14-digit Brazilian CNPJ numbers.
maxItems	Integer	Maximum number of partner records to collect.
requestDelaySecs	Number	Delay between lookups in seconds.

Example Input

{
  "mode": "cnpj",
  "cnpjs": [
    "19131243000197"
  ],
  "maxItems": 50,
  "requestDelaySecs": 1
}

What Data Does This Actor Extract?

Each dataset row represents one company partner record. Available fields may include:

Field	Description
cnpj	Parent company's CNPJ
nome_socio	Partner or shareholder name
qualificacao_socio	Partner's role or qualification
faixa_etaria	Partner's age range
codigo_faixa_etaria	Age range classification code
data_entrada_sociedade	Date the partner joined the company
cnpj_cpf_do_socio	Masked partner identification number, when available
identificador_de_socio	Partner identification category
pais	Partner's country
codigo_pais	Country code
cpf_representante_legal	Masked legal representative identification number, when available
nome_representante_legal	Legal representative's name
qualificacao_representante_legal	Legal representative's qualification
codigo_qualificacao_socio	Partner qualification code
codigo_qualificacao_representante_legal	Legal representative qualification code
scraped_at	Date and time the record was collected

Some fields may be empty or unavailable depending on the company record.

Example Output

{
  "pais": null,
  "nome_socio": "LUIZ CARLOS PINHO GUEDES",
  "codigo_pais": null,
  "faixa_etaria": "Entre 31 a 40 anos",
  "cnpj_cpf_do_socio": "***682847**",
  "qualificacao_socio": "Diretor",
  "codigo_faixa_etaria": 4,
  "data_entrada_sociedade": "2026-09-10",
  "identificador_de_socio": 2,
  "cpf_representante_legal": "***000000**",
  "nome_representante_legal": "",
  "codigo_qualificacao_socio": 10,
  "qualificacao_representante_legal": "Não informada",
  "codigo_qualificacao_representante_legal": 0,
  "cnpj": "19131243000197",
  "scraped_at": "2026-10-26T00:00:00+00:00"
}

Working with Your Dataset

After the run finishes, open the dataset in Apify Console to review the collected partner records.

You can:

• Export results as JSON, CSV, or Excel.
• Filter records by company CNPJ.
• Sort partners by name, qualification, or entry date.
• Import the data into spreadsheets, CRM systems, or data analysis workflows.
• Combine multiple company lookup results for further research.

FAQ

Who is this actor for?

It is designed for analysts, marketers, researchers, and developers who need Brazilian company partner information in a structured dataset.

What is QSA?

QSA stands for Quadro de Sócios e Administradores. It refers to the partners and administrators associated with a Brazilian company.

What can I export?

You can export JSON, CSV, Excel, and other supported Apify dataset formats.

Can I run it on a schedule?

Yes. You can configure an Apify schedule to run your CNPJ lookups automatically at your preferred intervals.

What happens if some company information is unavailable?

Unavailable fields may be empty or null. The actor can continue processing other submitted CNPJs.

Disclaimer

This actor is an independent tool and is not affiliated with, endorsed by, sponsored by, or officially associated with BrasilAPI or its owners. It collects information made publicly available through the service. Users are responsible for ensuring that their data collection and use comply with applicable laws and relevant terms.

Is Web Scraping Legal?

Collecting information that is already public is generally legal. There is no single law that bans all forms of web scraping. The limits are the usual ones: do not break into accounts, do not take private or confidential data, and be careful with personal data and copyrighted works. A site's terms can also restrict how you access it. Facts such as a public name, price, or rating are not the same thing as republishing someone's article or photo.

This actor collects information from public pages. It does not log in and it does not bypass access controls.

For a longer explanation, see Apify's article Is web scraping legal?.