Guia

Account Discovery API no Brasil

Como gerar listas de contas com CNAE/UF, base do mês fixa e fontes visíveis.

Checklist do perfil desejado

Defina CNAE principal (formato numérico).
Restringa por UF/município para evitar queries amplas.
Decida se precisa de contato (email/telefone).
Use base do mês fixa para repetibilidade.

Exemplo de filtros

json

{
  "kind": "lead_query",
  "spec_version": "1.0",
  "entity": "company",
  "filters": {
    "industry": { "cnae_any_of": ["6201500", "6202300"] },
    "geo": { "uf_any_of": ["SP"] },
    "contact": { "require_email": true }
  }
}

curl

bash

curl -X POST "https://api.orbioapi.com.br/v1/leads" \
  -H "Authorization: Bearer $ORBIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query_text": "software B2B em SP com email",
    "limit": 20,
    "output_format": "json"
  }'

Campos recomendados

cnpj14, razao_social, uf, municipio_ibge7
cnae_principal, porte, status
email, telefone (quando habilitado)

Erros comuns

Query ampla demais → adicione UF + CNAE.
Sem base do mês → defina snapshot_yyyymm.
Limite excedido → use export async.

Próximos passos

Para grandes volumes, use exports assíncronos e mantenha a base do mês visível no pipeline.

Export async Ver planos

Leitura recomendada

Guia: buscar empresas por CNAE.
Comparativo vs consulta CNPJ.
Limites e quotas por plano.

Guia CNAE Comparativo