Use case
Account discovery para ABM e outbound no Brasil
Gere listas de contas com filtros precisos, base do mês fixa e fontes visíveis.
Fluxo recomendado
- 1. Descreva o tipo de empresa que você quer.
- 2. Revise os filtros (CNAE/UF/porte/contato).
- 3. Execute e exporte com base do mês fixa.
Por que funciona
- Reprodutibilidade: a mesma base do mês retorna a mesma lista.
- Transparência: sempre sabe a fonte e a data.
- Escala: exports assíncronos e limites por plano.
Filtros que mais convertem
- CNAE principal + UF/cidade.
- Status ativo e faixa de porte.
- Contato (email/telefone) quando necessário.
Campos recomendados
- cnpj14, razao_social, uf, municipio_ibge7
- cnae_principal, porte, status
- email, telefone (se habilitado)
Boas práticas
- Defina a base do mês para repetir buscas.
- Comece com 20–50 registros para validar.
- Suba para export async quando escalar.
Request
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"
}'Response
json
{
"request_id": "req_demo_0001",
"snapshot_yyyymm": "2026-01",
"data_provenance": [
{ "source_id": "rfb_cnpj_open_data", "snapshot": "2026-01" }
],
"total_count": 842,
"leads": [
{
"cnpj14": "00000000000000",
"razao_social": "SOFTWARE EXEMPLO LTDA",
"uf": "SP",
"municipio_ibge7": "3550308",
"cnae_principal": "6201500",
"email": "contato@example.com"
}
]
}Erros comuns
- Query ampla demais → adicione UF + CNAE.
- Sem API key → rode em modo demo no Studio.
- Limite excedido → use export async.
Próximos passos
- Leia o guia completo para ABM.
- Use o recipe de export async.
- Veja limites e quotas por plano.