# Export Brazilian retail chain CNPJ data to CSV

**Use case:** 

For retail lead lists, distributor checks and market reports: Magazine Luiza, Lojas Renner, Raia Drogasil, Atacadao and Companhia Brasileira de Distribuicao (GPA) as flat rows - registered name, trade name, status, CNAE retail activity, share capital, address and phone from the Receita Federal CNPJ register. Export as JSON, CSV or Excel.

## Input

```json
{
  "cnpjs": [
    "47.960.950/0001-21",
    "92.754.738/0001-62",
    "61.585.865/0001-51",
    "75.315.333/0001-09",
    "47.508.411/0001-56"
  ],
  "maxRetries": 4
}
```

## Output

```json
{
  "cnpjFormatted": {
    "label": "Cnpj formatted",
    "format": "string"
  },
  "legalName": {
    "label": "Legal name",
    "format": "string"
  },
  "tradeName": {
    "label": "Trade name",
    "format": "string"
  },
  "registrationStatus": {
    "label": "Registration status",
    "format": "string"
  },
  "isActive": {
    "label": "Is active",
    "format": "boolean"
  },
  "openedOn": {
    "label": "Opened on",
    "format": "string"
  },
  "mainActivityCodeFormatted": {
    "label": "Main activity code formatted",
    "format": "string"
  },
  "mainActivity": {
    "label": "Main activity",
    "format": "string"
  },
  "legalNature": {
    "label": "Legal nature",
    "format": "string"
  },
  "companySize": {
    "label": "Company size",
    "format": "string"
  },
  "shareCapitalBrl": {
    "label": "Share capital brl",
    "format": "number"
  },
  "city": {
    "label": "City",
    "format": "string"
  },
  "state": {
    "label": "State",
    "format": "string"
  },
  "phone1": {
    "label": "Phone1",
    "format": "string"
  },
  "simplesNacional": {
    "label": "Simples nacional",
    "format": "boolean"
  },
  "mei": {
    "label": "Mei",
    "format": "boolean"
  },
  "shareholderCount": {
    "label": "Shareholder count",
    "format": "number"
  },
  "establishmentType": {
    "label": "Establishment type",
    "format": "string"
  },
  "status": {
    "label": "Status",
    "format": "string"
  },
  "note": {
    "label": "Note",
    "format": "string"
  },
  "source": {
    "label": "Source",
    "format": "string"
  },
  "input": {
    "label": "Input",
    "format": "string"
  },
  "cnpj": {
    "label": "Cnpj",
    "format": "string"
  },
  "cnpjRoot": {
    "label": "Cnpj root",
    "format": "string"
  },
  "personalDataWithheld": {
    "label": "Personal data withheld",
    "format": "boolean"
  },
  "registrationStatusCode": {
    "label": "Registration status code",
    "format": "number"
  },
  "registrationStatusSince": {
    "label": "Registration status since",
    "format": "string"
  },
  "registrationStatusReason": {
    "label": "Registration status reason",
    "format": "string"
  },
  "specialSituation": {
    "label": "Special situation",
    "format": "string"
  },
  "specialSituationSince": {
    "label": "Special situation since",
    "format": "string"
  },
  "legalNatureCode": {
    "label": "Legal nature code",
    "format": "number"
  },
  "companySizeCode": {
    "label": "Company size code",
    "format": "number"
  },
  "mainActivityCode": {
    "label": "Main activity code",
    "format": "string"
  },
  "secondaryActivities": {
    "label": "Secondary activities",
    "format": "array"
  },
  "secondaryActivityCount": {
    "label": "Secondary activity count",
    "format": "number"
  },
  "simplesOptedOn": {
    "label": "Simples opted on",
    "format": "string"
  },
  "simplesExcludedOn": {
    "label": "Simples excluded on",
    "format": "string"
  },
  "meiOptedOn": {
    "label": "Mei opted on",
    "format": "string"
  },
  "meiExcludedOn": {
    "label": "Mei excluded on",
    "format": "string"
  },
  "latestTaxRegime": {
    "label": "Latest tax regime",
    "format": "string"
  },
  "latestTaxRegimeYear": {
    "label": "Latest tax regime year",
    "format": "number"
  },
  "taxRegimeHistory": {
    "label": "Tax regime history",
    "format": "array"
  },
  "streetType": {
    "label": "Street type",
    "format": "string"
  },
  "street": {
    "label": "Street",
    "format": "string"
  },
  "number": {
    "label": "Number",
    "format": "string"
  },
  "complement": {
    "label": "Complement",
    "format": "string"
  },
  "neighborhood": {
    "label": "Neighborhood",
    "format": "string"
  },
  "postalCode": {
    "label": "Postal code",
    "format": "string"
  },
  "cityIbgeCode": {
    "label": "City ibge code",
    "format": "number"
  },
  "cityAbroad": {
    "label": "City abroad",
    "format": "string"
  },
  "countryAbroad": {
    "label": "Country abroad",
    "format": "string"
  },
  "phone1International": {
    "label": "Phone1international",
    "format": "string"
  },
  "phone2": {
    "label": "Phone2",
    "format": "string"
  },
  "phone2International": {
    "label": "Phone2international",
    "format": "string"
  },
  "fax": {
    "label": "Fax",
    "format": "string"
  },
  "shareholderNaturalPersons": {
    "label": "Shareholder natural persons",
    "format": "number"
  },
  "shareholderCompanies": {
    "label": "Shareholder companies",
    "format": "number"
  },
  "shareholderForeignNationals": {
    "label": "Shareholder foreign nationals",
    "format": "number"
  },
  "shareholders": {
    "label": "Shareholders",
    "format": "array"
  },
  "sourceDataMonth": {
    "label": "Source data month",
    "format": "string"
  },
  "sourceUrl": {
    "label": "Source url",
    "format": "string"
  },
  "checkedAt": {
    "label": "Checked at",
    "format": "string"
  }
}
```

## About this Actor

This example demonstrates how to use [Brazil CNPJ Scraper & Bulk Lookup - Receita Federal Data](https://apify.com/neverempty/brazil-cnpj-scraper.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/neverempty/brazil-cnpj-scraper.md) to learn more, explore other use cases, and run it yourself.


## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
This Task's input is already configured above — use it as-is rather than inventing a new one.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/neverempty/brazil-cnpj-scraper.md

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
