Resposta direta

API para encontrar empresas no Brasil (CNPJ/CNAE)

Orbio ajuda dev founder a gerar listas de empresas no Brasil por filtros como CNAE, UF, porte, status e contato, com base do mês fixa e reprodutível.

Request (curl)

Descreva o perfil e receba filtros deterministas com resultados paginados.

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"], "cnae_exclude": [], "secondary_cnae_mode": "off", "text_hints": ["software B2B"] },
        "geo": { "uf_any_of": ["SP"], "municipality_ibge_any_of": [], "municipality_tom_any_of": [] },
        "company": { "registration_status_any_of": [2], "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 }
      },
      "sort": [{ "field": "score", "direction": "desc" }],
      "scoring": { "strategy": "balanced", "random_seed": null },
      "output": { "format": "json", "include_explain": false, "fields": ["cnpj", "legal_name", "uf", "email"] },
      "explain": { "assumptions": [], "warnings": [], "unmapped_constraints": [], "confidence": 0.74 }
    }
  }'

Response (resumo)

Inclui `snapshot`, `snapshot_date` e origem dos dados para auditoria.

json
{
  "request_id": "req_01HX...",
  "snapshot": "<base_do_mes>",
  "snapshot_date": "<data_da_base>",
  "accounts": [
    { "cnpj": "00000000000000", "legal_name": "SOFTWARE EXEMPLO LTDA", "uf": "SP", "email": "contato@example.com" }
  ],
  "next_cursor": null,
  "has_more": false,
  "provenance": {
    "rfb_snapshot": "<base_do_mes>",
    "ibge_population_year": "not_available",
    "ceis_as_of_date": "not_available"
  }
}

Quando usar

  • Testar o perfil de cliente ideal sem montar base manual.
  • Rodar buscas recorrentes com resultado reprodutível por mês.
  • Exportar volumes grandes sem timeout (jobs async).

Limitações (sem surpresa)

  • Dados por base do mês (não é tempo real).
  • Queries amplas podem ser bloqueadas (sandbox exige CNAE + geo).
  • Campos e limites variam por plano.

Leitura em cluster

Para explorar o tema de ponta a ponta: comece pelo filtro por CNAE, avance para lista/CSV e compare com cenário de API gratuita.