search_companies
Find companies/establishments matching filters. Filters (all optional, combined with AND): cnae (CNAE code or prefix, e.g. '4711' or '47', list ok; add include_secondary to also match secondary activities), cnae_secao (letter A-U), uf, municipio (name as in Receita, accents ignored), municipio_codigo, situacao (ativa, baixada, suspensa, inapta, nula), matriz_only, porte (micro = ME, pequeno = EPP, demais, nao_informado), natureza_juridica (code prefix like '2062' or text like 'sociedade limitada'), capital_min/capital_max (BRL), opened_from/opened_to (data_inicio_atividade, YYYY-MM or YYYY-MM-DD), closed_from/closed_to (data da baixa), mei, simples (true/false), name_contains (razao social or nome fantasia), cep, partner_name (a partner's name contains this text). Returns up to 100 rows per page, ordered by opening date (newest first) unless order_by is capital_social or razao_social. Use count_companies for 'how many' questions. Set include_contacts to add email, phones, full address and a registry_contact_quality block (0-100 score of how likely the REGISTERED email/phone from Receita is a real direct contact, with the signals behind it; it says nothing about the website) and, when the company's own website was crawled, a separate website_contacts block (WhatsApp, phones, emails, social profiles found on its public pages, each with source_url). min_contact_score keeps only companies whose REGISTERED contact (the email and phones on the Receita record, not the website) scores at or above it. Pass an integer 0-100, or a tier name: 'high' = 85, 'medium' = 50, 'low' = 0 (e.g. min_contact_score=50 or 'medium' for medium and high). The filter is applied after the page is read, so a call scans at most 2000 candidates and returns pagination.next_offset to continue.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| uf | No | ||
| cep | No | ||
| mei | No | ||
| cnae | No | ||
| limit | No | ||
| porte | No | ||
| offset | No | ||
| simples | No | ||
| order_by | No | data_inicio_atividade | |
| situacao | No | ||
| closed_to | No | ||
| municipio | No | ||
| opened_to | No | ||
| cnae_secao | No | ||
| capital_max | No | ||
| capital_min | No | ||
| closed_from | No | ||
| matriz_only | No | ||
| opened_from | No | ||
| partner_name | No | ||
| name_contains | No | ||
| include_contacts | No | ||
| municipio_codigo | No | ||
| include_secondary | No | ||
| min_contact_score | No | ||
| natureza_juridica | No |