Orbio
Testar Studio
Guia

Buscar empresas por CNAE e UF

Exemplo completo com filtros avançados e base do mês fixa.

Checklist rápido

  • Escolha CNAE principal (formato numérico: 6201500).
  • Defina UF ou município para reduzir o escopo.
  • Peça contato (email/telefone) quando necessário.
Testar no StudioVer referência

Como escolher CNAE

  • Use CNAE principal quando quiser foco no core business.
  • Combine múltiplos CNAEs para capturar variações do segmento.
  • Para outbound, prefira CNAEs mais específicos.

Filtros extras que ajudam

  • Status ativo (evita registros inativos).
  • Faixa de porte ou número de funcionários.
  • Contato obrigatório (email/telefone).

curl

bash
curl -X POST "https://api.orbioapi.com.br/v1/leads" \
  -H "Authorization: Bearer $ORBIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "spec": {
      "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 }
      }
    },
    "limit": 20,
    "output_format": "json"
  }'

TypeScript

ts
import fetch from "node-fetch";

const res = await fetch("https://api.orbioapi.com.br/v1/leads", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.ORBIO_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    spec: {
      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 },
      },
    },
    limit: 20,
    output_format: "json",
  }),
});

const data = await res.json();

Python

py
import requests, os

res = requests.post(
  "https://api.orbioapi.com.br/v1/leads",
  headers={
    "Authorization": f"Bearer {os.environ['ORBIO_API_KEY']}",
    "Content-Type": "application/json",
  },
  json={
    "spec": {
      "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 },
      },
    },
    "limit": 20,
    "output_format": "json",
  },
)

data = res.json()

Erros comuns

  • Busca ampla demais → adicione UF e CNAE.
  • Sem resultados → revise CNAE e recorte geográfico.
  • Limite excedido → use export async.

Próximos passos

  • Veja o recipe de export async.
  • Leia o comparativo vs consulta CNPJ.
  • Cheque limites e quotas por plano.
Export asyncComparativo