Checklist rápido
- Escolha um CNAE principal no formato
0000-0/00. - Combine mais de um CNAE apenas quando a tese comercial realmente exigir.
- Restrinja a busca por UF, município ou ambos.
- Decida se a lista precisa de contato obrigatório.
curl
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",
"filters": {
"industry": { "cnae_any_of": ["6201-5/00", "6202-3/00"], "secondary_cnae_mode": "off" },
"geo": { "uf_any_of": ["SP"] },
"contact": { "require_email": true }
}
},
"limit": 20,
"output": { "format": "json", "fields": ["cnpj", "legal_name", "uf"] }
}'TypeScript
ts
const res = await fetch("https://api.orbioapi.com.br/v1/accounts/search", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.ORBIO_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
spec: {
kind: "account_query",
spec_version: "2.0",
entity: "company",
filters: {
industry: { cnae_any_of: ["6201-5/00", "6202-3/00"], secondary_cnae_mode: "off" },
geo: { uf_any_of: ["SP"] },
contact: { require_email: true },
},
},
limit: 20,
output: { format: "json", fields: ["cnpj", "legal_name", "uf"] },
}),
});Python
py
import os
import requests
res = requests.post(
"https://api.orbioapi.com.br/v1/accounts/search",
headers={
"Authorization": f"Bearer {os.environ['ORBIO_API_KEY']}",
"Content-Type": "application/json",
},
json={
"spec": {
"kind": "account_query",
"spec_version": "2.0",
"entity": "company",
"filters": {
"industry": {"cnae_any_of": ["6201-5/00", "6202-3/00"], "secondary_cnae_mode": "off"},
"geo": {"uf_any_of": ["SP"]},
"contact": {"require_email": True},
},
},
"limit": 20,
"output": {"format": "json", "fields": ["cnpj", "legal_name", "uf"]},
},
)Filtros extras que ajudam
- Status cadastral ativo para reduzir ruído.
- Matriz apenas quando a operação quer evitar duplicidade.
- Faixa de porte quando o perfil de cliente ideal depende de capacidade comercial.
Erros comuns
- Busca ampla demais: adicione UF e refine a lista de CNAEs.
- Sem resultados: reveja a granularidade do CNAE ou use cidades maiores primeiro.
- Limite excedido: escale para export assíncrono.