# BR Company Data – Mass Company Search & Segmentation

> BR Company Data – Mass Company Search & Segmentation is a paid API for AI agents from brdata.thomenz.me, paid per call via x402, $0.015/call, status unknown (last checked 2026-09-14).

Search and filter across ~28 million active Brazilian companies by CNPJ, sector, size, location, and other criteria, returning paginated profiles with contact, address, and activity data.

## Facts

- Endpoint: POST https://brdata.thomenz.me/companies/search
- Price: $0.015/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/br-company-data-mass-company-search-segmentation-09047f93
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_F5vK7ttmw0plUrwlxsRNM

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability br-company-data-mass-company-search-segmentation-09047f93 -d '<json body>'
```

Example prompt: Search for active dental clinics (CNAE 8630501) in Campo Grande, Mato Grosso do Sul — small and micro companies only — and give me their names, CNPJs, phones, and emails so I can build a prospect list.

## When to prefer this

Use this endpoint when you need to search or segment across the full universe of ~28M active Brazilian companies by any combination of industry, location, or size — ideal for B2B prospecting, market research, and supplier discovery. Prefer this over the single-CNPJ lookup endpoints when you don't have a specific CNPJ and need to discover companies matching criteria at scale.

## Known failure modes

- Invalid or unsupported filter parameters return a 400 error
- Expired or invalid cursor token causes pagination failure
- No matching companies found returns empty results array with count_estimate 0
- Rate limiting or payment failure (x402) blocks the request
- Overly broad queries may return capped estimates rather than exact counts
- Data freshness limited to the dump_reference_month; very recently registered companies may be absent

## How this service works

Search and segment active Brazilian companies by industry (CNAE, main OR secondary), location, size, age, share capital and name. Returns official registry data with business contact info. Ideal for B2B lead generation and market research on Brazil. Priced per page ($0.015). CNAE accepts 4-7 digit prefixes, masked or not (6201-5/01 = 6201501). MEI contact data is redacted (LGPD).

## Output

A paginated JSON array of company records, each containing CNPJ (raw and formatted), legal name, trade name, company size classification, main CNAE activity code and description, secondary CNAE codes, full address (street, number, neighborhood, city, state, ZIP), phone numbers, email, registration date, share capital in BRL, and flags for MEI and Simples Nacional status. Also includes a next_cursor token for pagination, an estimated result count (may be capped), and the reference month of the underlying data dump.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "results": [
   {
    "cnpj": "12345678000191",
    "email": "contato@sorrisoodonto.com.br",
    "is_mei": false,
    "phones": [
     "(67) 33334444"
    ],
    "address": {
     "zip": "79002000",
     "city": "CAMPO GRANDE",
     "state": "MS",
     "number": "100",
     "street": "RUA DAS FLORES",
     "neighborhood": "CENTRO"
    },
    "is_simples": true,
    "legal_name": "CLINICA ODONTOLOGICA SORRISO LTDA",
    "trade_name": "SORRISO ODONTO",
    "company_size": "ME",
    "main_activity": {
     "cnae_code": "8630501",
     "description_pt": "Atividade odontológica"
    },
    "cnpj_formatted": "12.345.678/0001-91",
    "registration_date": "2019-03-10",
    "share_capital_brl": 50000,
    "secondary_cnae_codes": [
     "8640202",
     "4772500"
    ]
   }
  ],
  "data_policy": "Company-level public registry data only. Source: Brazilian Federal Revenue open data.",
  "next_cursor": "12345678000191",
  "count_estimate": {
   "value": 1000,
   "is_capped": true
  },
  "dump_reference_month": "2026-06-01"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/br-company-data-mass-company-search-segmentation-09047f93/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from brdata.thomenz.me](https://www.zero.xyz/host/brdata.thomenz.me/llms.txt)