Orbio
Base URL: https://api.orbioapi.com.br

Filtrar por CNAE + UF

Objetivo: retornar empresas com CNAE específico em uma UF (ou município).

Pré‑requisitos

  • CNAE no formato 0000-0/00.
  • API key válida.

Passos

  1. Monte um spec com filtros de indústria e geografia.
  2. Envie no endpoint /v1/accounts/search.
json
Testar
{
  "spec": {
    "kind": "account_query",
    "spec_version": "2.0",
    "entity": "company",
    "filters": {
      "industry": {
        "cnae_any_of": ["6201-5/00", "6202-3/00"],
        "cnae_exclude": [],
        "secondary_cnae_mode": "off",
        "text_hints": ["software", "saas"]
      },
      "geo": {
        "uf_any_of": ["SP"],
        "municipality_ibge_any_of": [],
        "municipality_tom_any_of": []
      },
      "company": {
        "registration_status_any_of": [],
        "company_size_code_any_of": [],
        "headquarters_only": true,
        "simples_opt_in": null,
        "mei_opt_in": null,
        "started_after": null,
        "started_before": null
      },
      "contact": {
        "require_email": true,
        "require_phone": false,
        "require_any_contact": false
      }
    }
  },
  "limit": 20,
  "output": {
    "format": "json",
    "include_explain": false,
    "fields": ["cnpj", "legal_name", "uf", "municipality_ibge", "cnae_primary"]
  }
}

Verificação

  • Resposta 200 com accounts.
  • spec retorna normalizado.

Erros comuns

  • 422 query_too_broad: faltou recorte geográfico.
  • 422 invalid_spec: CNAE inválido.

Veja exemplos em Erros e códigos.

Conceitos relacionados