Brazil CNPJ Legal Processes Scraper Lawsuits & Litigation Risk

What does Brazil CNPJ Legal Processes Scraper - Lawsuits & Litigation Risk Summary do?

Brazil CNPJ Legal Processes Scraper - Lawsuits & Litigation Risk Summary helps you screen Brazilian companies for judicial exposure by using a Brazilian company tax ID, known as CNPJ. It returns a structured summary for each submitted company, with the total number of captured lawsuits and aggregated statistics by lawsuit type, court, state, status, party role, court type, court level, CNJ procedure type, CNJ subject and broad CNJ subject. The result is designed for due diligence, supplier review, credit analysis, compliance workflows and recurring monitoring.

The Actor analyzes the last three years of captured processes in which the company appears as defendant or respondent. It is a summary Actor, not a case detail scraper. You receive counts and distribution maps instead of individual case numbers, parties, dates or movement histories. This makes it useful as a first screening step for a large list of companies. When a company deserves deeper investigation, continue with Brazil CNPJ Legal Processes Scraper - Lawsuit Case Details, which is designed for individual lawsuit records and sequential pagination.

The input accepts up to 100 CNPJs in one run. CNPJs can be provided with punctuation, such as 02.342.260/0001-70, or as digits only, such as 02342260000170. The output preserves both the normalized digits and a formatted CNPJ when a company is found. A company with no captured lawsuits still receives a valid summary row. If the source cannot answer a CNPJ, the Actor records the situation in the run log and does not create a result row for that CNPJ.

The output is suitable for people who want to inspect a risk overview in the Apify Console and for developers who want to connect results to another system. You can use the Apify API, scheduled runs, webhooks and integrations to move the Dataset into a review process. The Dataset can be downloaded in JSON, HTML, CSV or Excel formats. The API returns the complete structured record, including the dynamic distribution maps.

Why use Brazil CNPJ Legal Processes Scraper - Lawsuits & Litigation Risk Summary?

Judicial exposure is often difficult to compare when every source returns a different format. This Actor converts the captured information into one consistent row per analyzed CNPJ. The total process count gives you an initial volume indicator, while the distribution maps help explain where that volume comes from. For example, a company can have many tax execution cases, a concentration in one state, a high share of archived cases or a large number of cases in a particular court type. These patterns can guide the next question without requiring a manual review of every case.

Use the Actor before an acquisition, investment, partnership or major supplier decision. A batch of company tax IDs can be screened together, allowing a legal or procurement team to prioritize the companies that need case-level investigation. The summary is also useful when a portfolio contains many customers, vendors, borrowers or counterparties and the review team needs a repeatable first filter.

The Actor supports several practical workflows:

• M&A and investment due diligence: compare litigation volume and categories before advancing a transaction.
• Supplier onboarding: add judicial exposure to the checks performed before approving a new vendor.
• Credit and lending analysis: use lawsuit totals and distributions as one input in a broader credit review.
• Compliance operations: identify companies that require additional documentation or manual assessment.
• Portfolio monitoring: schedule recurring runs for important counterparties and compare new results with previous datasets.
• Legal research: create a structured starting point for comparative research across companies, states and court categories.

The main advantage of using Apify is operational. You can run the Actor manually for an immediate review, call it through the API from an internal application, schedule it in the Apify Console or connect it to a workflow that stores and evaluates the Dataset. Apify also provides run history, logs, Dataset storage and downloadable formats, so the process does not depend on a local script running on one computer. Use the companion detail Actor when the summary identifies a company that needs individual case records.

This Actor does not return a legal opinion, a probability of losing a case or a recommendation to approve or reject a company. It provides structured information for a qualified review. The result should be interpreted together with the relevant contract, financial, regulatory and legal context.

How to use Brazil CNPJ Legal Processes Scraper - Lawsuits & Litigation Risk Summary

1. Open the Actor page and select the Input tab.
2. Enter one or more Brazilian company tax IDs in the cnpjs array. You can use digits only or the common formatted CNPJ representation.
3. Keep the list at or below 100 CNPJs for the run.
4. Start the run and wait for the Dataset to become available.
5. Open the Output tab to inspect the summary rows. Use the full fields view when you need all distribution maps.
6. Check encontrado, erro and totalProcessos before interpreting the statistics.
7. Review the distribuicao maps to identify concentrations by type, court, status, state and party role.
8. If a company requires case-level evidence, copy its CNPJ into Brazil CNPJ Legal Processes Scraper - Lawsuit Case Details.
9. Download the Dataset as JSON, HTML, CSV or Excel when the review team needs a file.
10. For automation, call the run-sync endpoint from your application or create a recurring schedule in Apify.

The same workflow can be used for a single company or a batch. For a first investigation, one CNPJ is convenient because the output is easy to inspect. For procurement or portfolio screening, a batch of CNPJs reduces repetitive manual work. When a run is scheduled, keep the input list current and retain the previous Dataset so the team can compare changes over time. Apify run logs are useful when a source cannot answer a specific CNPJ or when an execution needs operational investigation.

API example

The following request starts a synchronous run and returns Dataset items. Replace the masked token with your own token in your local environment. Never expose an API token in source code, a README, a browser application or a public issue.

curl -X POST "https://api.apify.com/v2/acts/brasildados~cnpj-lawsuits-check/run-sync-get-dataset-items" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"cnpjs":["02.342.260/0001-70","11222333000144"]}'

Input

The input contains one required array.

Field	Type	Required	Description
cnpjs	array of strings	Yes	Brazilian company tax IDs to analyze. Maximum 100 entries per run. Punctuation is accepted.

Example input for the Console or API:

{
  "cnpjs": [
    "02.342.260/0001-70",
    "11222333000144"
  ]
}

Each value is trimmed and only ., - and / are removed. The CNPJ check digits are then validated: invalid values, CPFs and text are skipped with a warning before any query, are not charged and do not abort the run. Do not add company names, addresses or extra properties to the input object because they are not part of the public input contract. If you have a spreadsheet, extract the CNPJ column, clean duplicate values in your own workflow and then send the resulting list.

The maximum of 100 CNPJs applies to one execution. For a larger portfolio, divide the input into batches and use an Apify schedule, API client or external queue to run the batches. Store the run ID and Dataset ID if you need a traceable audit record. A batch is not a substitute for legal review, but it creates a repeatable starting point.

Output

The Dataset contains one top-level result object for each CNPJ that the source successfully answers. A company with no lawsuits is still represented by a result with a zero total. A CNPJ that the source cannot answer is logged and does not produce a Dataset row.

Example output:

[
  {
    "cnpj": "02342260000170",
    "cnpjFormatado": "02.342.260/0001-70",
    "consultadoEm": "2026-08-25T20:33:29.132Z",
    "encontrado": true,
    "erro": null,
    "totalProcessos": 73,
    "distribuicao": {
      "porTipo": {
        "EXECUCAO FISCAL": 10,
        "CUMPRIMENTO DE SENTENCA": 11
      },
      "porNomeTribunal": {
        "JFSP": 10,
        "TJSP": 30
      },
      "porStatus": {
        "ARQUIVADO": 39,
        "EM GRAU DE RECURSO": 1
      },
      "porEstado": {
        "SP": 40,
        "DF": 4
      },
      "porTipoParticipacao": {
        "CLAIMED": 58,
        "DEFENDANT": 21
      },
      "porTipoTribunal": {
        "TRIBUTARIA": 16,
        "CIVEL": 54
      },
      "porNivelTribunal": {
        "1": 57,
        "2": 20
      },
      "porTipoProcedimentoCnj": {
        "EXECUCAO FISCAL": 10
      },
      "porAssuntoCnj": {
        "DIREITO TRIBUTARIO": 3
      },
      "porAssuntoCnjAbrangente": {
        "DIREITO CIVIL": 30
      }
    }
  }
]

Field names are in Portuguese because they are part of the existing Dataset contract. The maps inside distribuicao use dynamic keys. A key is a category label returned by the source and its value is the number of captured processes in that category. Do not assume that every possible label will appear in every response. A missing category normally means that the source did not report a process in that category for the analyzed company.

You can inspect results in the Apify Console or retrieve them through the API. The Dataset export options include JSON, HTML, CSV and Excel. JSON is usually the best choice for another application because it preserves nested distribution maps. CSV and Excel are convenient for analysts who want to filter rows, create pivot tables or share a review workbook. HTML is useful for a quick browser-based inspection.

Data table

Field	Meaning
cnpj	Normalized Brazilian company tax ID with digits only.
cnpjFormatado	Same CNPJ in the conventional formatted representation.
consultadoEm	Timestamp of the consultation in ISO format.
encontrado	Indicates whether the source returned a company result.
erro	Error or source status when applicable. Normally null for a successful result.
totalProcessos	Total number of captured lawsuits in the defined source window.
distribuicao.porTipo	Counts grouped by lawsuit type.
distribuicao.porNomeTribunal	Counts grouped by court name or court identifier.
distribuicao.porStatus	Counts grouped by current or reported status.
distribuicao.porEstado	Counts grouped by Brazilian state or UF.
distribuicao.porTipoParticipacao	Counts grouped by the company participation role reported by the source.
distribuicao.porTipoTribunal	Counts grouped by broad court category.
distribuicao.porNivelTribunal	Counts grouped by court level.
distribuicao.porTipoProcedimentoCnj	Counts grouped by CNJ procedure type.
distribuicao.porAssuntoCnj	Counts grouped by detailed CNJ subject.
distribuicao.porAssuntoCnjAbrangente	Counts grouped by broad CNJ subject.

The category totals are distributions, not necessarily independent totals. One source classification can have different dimensions, and the sum of one map should not be compared with the sum of another map as if they represented separate groups. totalProcessos is the primary overall count. The distribution maps explain that count from different perspectives.

Pricing / Cost estimation

Each successfully analyzed CNPJ produces one summary row in the default Dataset, including companies with zero captured lawsuits. A CNPJ that the source cannot answer is logged and produces no result row. The amount charged is configured in the Apify Store Monetization tab and is not repeated in this README.

The number of Dataset rows is therefore determined by the number of CNPJs that produce valid results, not by the number of nested categories in distribuicao and not by the number of processes represented by totalProcessos. The summary Actor does not create one row for every lawsuit. If you need individual lawsuit records, use the companion detail Actor and review its own output and billing behavior.

Tips or Advanced options

For a fast first pass, submit a batch of companies and sort the returned data by totalProcessos in your analysis tool. Then inspect the distribution maps for concentration. A high count does not automatically mean that a company is unsafe, and a low count does not guarantee that there is no relevant risk. Status, court type, state, participation role and the age of the source window all matter.

Keep the original CNPJ together with the returned normalized value in your internal review table. This makes it easier to match the result to procurement, finance or CRM records. Use consultadoEm to show when the information was collected. When a review is recurring, save the Dataset from each run and compare the rows instead of overwriting the previous result.

Use the summary Actor for triage and the detail Actor for investigation. This two-step workflow avoids downloading case-level information for every company when only a subset needs deeper review. The detail Actor supports sequential pagination, so use it after a summary result identifies a company that deserves additional attention.

Apify can schedule recurring runs, retain run history and expose the Dataset through its API. A webhook or integration can notify a review system after a run completes. If you build an internal workflow, treat erro, encontrado and missing rows as explicit states rather than silently treating them as zero lawsuits. This distinction prevents a source response problem from being confused with a clean legal result.

FAQ, disclaimers and support

Does this Actor return individual lawsuit numbers?

No. It returns totals and aggregated distribution maps. For case numbers, parties, dates and other individual records, use Brazil CNPJ Legal Processes Scraper - Lawsuit Case Details.

Which period and party role are covered?

The Actor uses the last three years of captured processes and focuses on companies reported as defendant or respondent. The available categories and labels depend on the source response.

What happens when a company has too many lawsuits to aggregate?

For companies with an extremely high litigation volume, the source cannot build the distribution. That CNPJ is reported in the run log, produces no row and is not charged. A missing row is not proof that the company has no lawsuits.

What happens when a CNPJ has no lawsuits?

A successfully answered CNPJ receives a valid summary row with totalProcessos equal to zero and the corresponding fields populated according to the source response. It should not be confused with a CNPJ that the source could not answer.

Is the information legal advice?

No. This Dataset is an information and research aid. It does not replace advice from a qualified lawyer, official court verification, contract review or a decision based on the complete facts of a case. Use the information for a legitimate business purpose and apply applicable privacy, data protection and compliance requirements, including LGPD where relevant.

How can I get support?

First check the run log, input format and output fields. If the issue continues, use the Actor Store support or Issues area and include the run ID, a short description of the expected behavior and a sanitized example. Do not publish API tokens, personal data or confidential case information in a support request. For documentation and BrasilDados services, visit brasildados.org.

Other BrasilDados Actors

Actor	When to use
Brazil CNPJ Legal Processes Scraper - Lawsuit Case Details	Investigate individual lawsuit records after summary screening
CNPJ Enrichment	Add company profile and QSA information before risk review
Brazil Sanctions Check	Check federal sanctions and compliance lists

All BrasilDados Actors: apify.com/brasildados

Resumo em português

Este Actor faz uma triagem de processos judiciais por CNPJ e retorna uma linha estruturada para cada empresa que a fonte consegue consultar. O resultado inclui o total de processos dos últimos três anos como réu ou reclamado, além de estatísticas por tipo, tribunal, estado, situação, papel da empresa, tipo de tribunal, nível do tribunal, procedimento CNJ e assunto CNJ. O limite é de 100 CNPJs por execução. CNPJs sem processos recebem uma linha válida com total igual a zero. Quando a fonte não consegue responder, o CNPJ é registrado no log e não gera linha no Dataset.

Use o Actor para diligência, análise de fornecedores, crédito, compliance e monitoramento de contrapartes. Para consultar números de processos, partes, datas e outros detalhes individuais, use o Actor de detalhes indicado acima. Os resultados podem ser consultados pela API da Apify, agendados no Console, integrados a outros fluxos e baixados em JSON, HTML, CSV ou Excel. A informação não substitui análise jurídica ou consulta oficial ao tribunal.