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).
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.

