Fluxo recomendado
- Descreva o tipo de empresa que você quer.
- Revise os filtros de CNAE, geografia, porte e contato.
- Execute a busca em lote pequeno.
- Escale para export quando a tese estiver validada.
Por que funciona
- Base do mês fixa para reproduzir listas.
- Filtros combináveis para reduzir ruído.
- Integração por API para produto ou operação interna.
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"] },
"contact": { "require_email": true }
}
}
}'Response esperada
json
{
"request_id": "req_demo_0001",
"snapshot": "AAAA-MM",
"has_more": false,
"accounts": [
{
"cnpj": "00000000000000",
"legal_name": "SOFTWARE EXEMPLO LTDA",
"uf": "SP",
"cnae_primary": "6201500",
"email": "contato@example.com"
}
]
}Boas práticas
- Comece com 20 a 50 registros para validar aderência.
- Prenda o snapshot antes de compartilhar a lista com o time.
- Passe para export assíncrono quando o recorte estiver validado.