Account discovery no Brasil: como gerar listas de contas por API

Checklist do perfil desejado

Defina CNAE principal no formato 0000-0/00.
Restrinja por UF ou município para evitar buscas amplas.
Decida se a operação precisa de e-mail, telefone ou qualquer contato.
Use a base do mês para repetibilidade comercial e analítica.
Valide se o recorte faz sentido para account discovery antes de escalar para export.

Resposta curta

Account discovery funciona melhor quando você combina intenção comercial com filtros estruturados. Em vez de puxar uma lista genérica, comece por um CNAE principal, restrinja a geografia, aplique porte quando fizer sentido e só depois escale para export. Isso reduz ruído, melhora o aproveitamento comercial e facilita repetir a busca no mesmo snapshot.

Quando usar account discovery

Use este fluxo quando a meta é descobrir contas novas para outbound, priorizar segmentos por CNAE ou montar listas reproduzíveis por região. Se você já sabe o CNPJ e quer apenas enriquecer um registro, prefira lookup; se precisa descobrir empresas aderentes ao ICP, account discovery é o caminho certo.

Exemplo de request

bash

curl -X POST "https://api.orbioapi.com.br/v1/accounts/search" \
  -H "Authorization: Bearer $ORBIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "spec": {
      "kind": "account_query",
      "spec_version": "2.0",
      "entity": "company",
      "limit": 20,
      "filters": {
        "industry": { "cnae_any_of": ["6201-5/00", "6202-3/00"], "secondary_cnae_mode": "off" },
        "geo": { "uf_any_of": ["SP"] },
        "company": { "registration_status_any_of": [2], "headquarters_only": true },
        "contact": { "require_email": true }
      }
    },
    "output": {
      "format": "json",
      "fields": ["cnpj", "legal_name", "uf"]
    }
  }'

Campos recomendados

cnpj, legal_name, uf, municipality_ibge
cnae_primary, company_size_code, registration_status
email e phone1 quando a operação exigir contato

Erros comuns

Query ampla demais: adicione UF e CNAE principal.
Snapshot ignorado: salve a base do mês para reproduzir listas antigas.
Volume alto no sync: migre para export assíncrono.

Quando usar este fluxo

Esse é o guia base para account discovery. A partir dele, faça o recorte por CNAE, leve a lista para export CSV e compare as abordagens quando o caso pedir.

Próximas otimizações recomendadas

Ajustar o título e a descrição da página conforme os termos que começarem a ganhar impressão no GSC.
Priorizar links internos vindos de guias de export e segmentação para reforçar a descoberta de contas.
Registrar o snapshot e o filtro vencedor antes de transformar a busca em rotina comercial.

Account discovery no Brasil por API