5 cenários práticos

Casos de uso

Como pessoas reais usam a plataforma na prática — agência, freelancer, dev, analista, vendedor. Cada caso lista os filtros brasileiros sugeridos (CNAE, UF, porte, MEI, Simples Nacional, matriz/filial, aberturas recentes), o resultado esperado e o link pra começar. Plataforma é self-service — você executa cada caso direto, sem agendamento, sem onboarding manual.

Encontramos empresas recém-abertas na base da Receita Federal via consulta por data de abertura. Atualização conforme bases públicas da Receita Federal — não é monitoramento em tempo real, e não prometemos atualização diária.

Sem ideia de por onde começar? Veja o Radar de oportunidades — 10 atalhos prontos (recém-abertas, MEIs com telefone, tecnologia, saúde, comércio local) que abrem direto no /buscar com filtros aplicados.

Caso 1

Agência de marketing

Equipe de mídia/performance que precisa montar lista B2B segmentada pra campanha (LinkedIn Ads, Google Ads, email outbound rodando no CRM próprio).

Problema

Cliente é "varejo de moda em SP capital" — você precisa de uma lista de empresas ativas daquele nicho, com contato (email/telefone público) e dados pra segmentar audience no LinkedIn ou disparar lookalike.

Como usar

Em /buscar, combine os filtros brasileiros da Receita Federal:

• UF = SP
• CNAE fiscal = vestuário/comércio (ex: 4781400)
• Porte = 01 (ME) ou 03 (EPP) — separa pequena empresa de multinacional
• Situação cadastral = Ativa (default)
• Apenas Simples Nacional e matriz/filial — recortes fiscais
• Com email ou com telefone = sim (filtros de presença)
• Aberturas recentes: pra leads novos, use aberturaMin ou o atalho /v1/public/aberturas

Resultado

Export CSV ou XLSX da lista (Pro com colunas de Lead Score, Starter sem). Importa direto no seu CRM (HubSpot, Pipedrive, Sheets) — a plataforma não envia campanha em seu nome, mas entrega a lista limpa pra você disparar pelo seu canal. Já tem uma lista própria de CNPJs? Sobe a planilha em /dashboard/enriquecer (Starter+) e baixa o mesmo arquivo enriquecido com razão social, situação cadastral, CNAE e capital social.

Caso 2

Freelancer / negócio local

Designer, social media, copywriter ou consultor solo que precisa achar negócios reais perto de onde mora pra prospectar 1-a-1.

Problema

Você atende empresas pequenas no seu bairro/cidade. Pegar a Junta Comercial demora; lista de WhatsApp comprada chega queimada. Você quer um recorte enxuto e qualificado — 50–200 empresas ativas no seu município com contato público — pra mandar 5–10 mensagens por dia personalizadas.

Como usar

Em /buscar, use:

• Município = código RF (ex: 7107 = Macapá)
• CNAE = nicho que você atende (ex: 5611201 = restaurantes)
• Situação = Ativa (default)
• Porte = 01/03 (filtra MEI/ME/EPP — pula multinacional)

Dá pra começar de graça (Free): 100 leads/mês exportados.

Resultado

Lista compacta com razão social, endereço, telefone e email públicos (quando a RF tem registrado). Você usa o próprio canal (email pessoal, telefone direto) pra iniciar conversa — a plataforma não envia mensagem, não dispara cadência, não integra ferramenta de mensageria.

Caso 3

Dev / integrador

Desenvolvedor que está integrando consulta CNPJ ou busca de empresas no produto/SaaS dele (ERP interno, fintech, marketplace, sistema fiscal etc).

Problema

Seu sistema precisa: (a) hidratar dados de uma empresa por CNPJ quando o cliente cadastra (preencher razão social + capital + endereço automaticamente); (b) opcionalmente buscar empresas por filtro dentro do seu produto sem você ter que ingerir 67M de linhas da RF na sua infra.

Como usar

Use a API pública via header x-api-key — endpoints com filtros brasileiros (CNAE, UF, município, porte, situação cadastral, MEI/Simples) nativos:

• GET /v1/public/cnpj/:cnpj — detalhe full
• GET /v1/public/search?... — busca por filtros RF
• GET /v1/public/stats — release atual + counts
• POST /v1/public/enrich-batch — enriquece lista de CNPJs em JSON (Pro 100 / Enterprise 1000 por request)
• GET /v1/public/aberturas — empresas recém-abertas nos últimos N dias (Pro até 90, Enterprise até 365)

Disponível a partir do plano Pro (60 req/min, até 2 chaves) ou Enterprise (300 req/min, até 10 chaves). Documentação completa em /docs — exemplos cURL, Node.js (fetch nativo) e Python (requests) prontos pra colar.

Resultado

Integração funcionando em uma tarde. Você cria a chave em /dashboard/api (a plena aparece uma única vez — anote no gerenciador de senhas), testa via Postman collection que disponibilizamos, e plugga no seu backend.

Caso 4

Pesquisador / analista

Profissional de inteligência de mercado, estrategista B2B, jornalista de dados, mestrando — gente que precisa fatiar a base do CNPJ pra estudo, relatório ou BI.

Problema

Você quer responder perguntas como "quantas microempresas de tech abriram em SP nos últimos 12 meses?", "qual a distribuição de capital social no setor de construção em MG?", ou exportar uma amostra setorial pra alimentar Tableau/Power BI/ Pandas.

Como usar

Em /buscar, combine:

• CNAE setorial (até 50 valores aceitos)
• UF ou município
• Data abertura mín/máx — janela temporal
• Capital social mín/máx — recorte por porte real
• Apenas Simples Nacional ou Apenas MEI — regime tributário

Exporte em CSV (ETL/Pandas/SQL) ou XLSX nativo (Excel/Google Sheets/LibreOffice). Pro/Enterprise vem com colunas de Lead Score (commercial, risk, segment, persona) — útil pra clusterizar por perfil.

Resultado

Dataset segmentado pronto pra análise. Origem rastreável (base pública RF · CC0) — citável em paper acadêmico ou release de imprensa.

Caso 5

Vendedor B2B priorizando leads

BDR/SDR/AE com pipeline contínuo — você já sabe seu ICP (porte, região, setor), agora precisa decidir <em>quem chamar primeiro</em> dentro da lista enorme.

Problema

Você tem 5.000 empresas no seu funil de "potenciais". Disparar cadência idêntica pra todas é desperdício de touch — empresas com pouco capital social, abertas no mês passado e em situação suspensa convertem mal. Você precisa de priorização objetiva sem inventar critério na base do achismo.

Como usar

Use /buscar com os filtros brasileiros do seu ICP (CNAE, UF, município, porte, situação cadastral, MEI/Simples, matriz/ filial), depois ative ordenação por Lead Score:

• Score Comercial — sinal de fit comercial (porte, capital, idade, situação)
• Score de Risco — sinal de risco/instabilidade da empresa

Pra novos leads, combine com aberturas recentes (filtro aberturaMin em /buscar ou endpoint /v1/public/aberturas — Pro até 90 dias). Disponível a partir do Starter (R$ 39/mês) na busca. Em Pro/Enterprise, as colunas de score também vão no CSV/XLSX exportado pra você re-classificar no spreadsheet ou alimentar seu CRM.

Resultado

Lista priorizada — top 20% das empresas pra atacar primeiro, bottom 30% pra cadência slow ou descarte. Lead Score é determinístico (calculado em SQL puro sobre dados RF; sem rede neural, sem caixa-preta), então você consegue auditar por que a empresa pontuou X — não é sinal opaco de "IA".