br_company_count
Read-only
Free. How many ACTIVE Brazilian establishments match a prospecting filter (CNAE code or prefix, state/UF, city, opening date range, headquarters only), from the Receita Federal monthly registry. Use it to budget pages before paying for br_company_list. Rate limited (50/day).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | Municipality name (accents and case ignored). | |
| cnae | No | CNAE code or prefix: '6201-5/00', '6201500', '6201' (class) or '62' (division). | |
| state | No | UF, e.g. 'SP'. | |
| hq_only | No | Only headquarters (one row per company). | |
| opened_after | No | Opened on or after (YYYY-MM-DD). | |
| opened_before | No | Opened on or before (YYYY-MM-DD). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| total | Yes | ||
| cached | Yes | ||
| filters | Yes | ||
| sources | Yes | ||
| summary | Yes | Short summary in English and Portuguese. | |
| generated_at | Yes | ||
| pages_of_100 | Yes | ||
| data_freshness | Yes | ||
| reference_month | Yes |