Buscar Preview de Leads
Este endpoint permite visualizar métricas e filtros que serão aplicados à sua busca, sem retornar os dados completos. Útil para entender o volume de resultados antes de executar uma busca completa.URL do Endpoint
Parâmetros
Query Parameters
Array de CNPJs em formato JSON para busca. Exemplo:
["21071712000171", "12345678000195"]Exemplo de Requisição
Resposta de Sucesso
Estrutura da Resposta
Campos Principais
Indica se a busca retornará resultados vazios
Filtros que serão aplicados na busca baseados nos CNPJs fornecidos
Métricas quantitativas dos resultados esperados
Códigos de Status
| Status | Descrição | Solução |
|---|---|---|
200 | ✅ Sucesso - Preview gerado | Continue com a busca completa se necessário |
400 | ❌ Parâmetros inválidos | Verifique o formato do array de CNPJs |
401 | ❌ Não autorizado | Verifique suas credenciais de autenticação |
429 | ⚠️ Limite de taxa excedido | Aguarde antes de fazer nova requisição |
500 | ❌ Erro interno do servidor | Tente novamente ou contate o suporte |
Casos de Uso
1. Validação Antes da Busca
Use este endpoint para verificar se sua busca retornará resultados úteis antes de consumir sua cota de requisições.2. Análise de Filtros
Entenda quais filtros serão aplicados automaticamente baseados nos CNPJs fornecidos.3. Estimativa de Volume
Obtenha métricas sobre quantos dados você pode esperar de uma busca completa.Limites e Considerações
- Rate Limit: 100 requisições por minuto
- CNPJs por Requisição: Até 100 CNPJs
- Cache: Resultados podem ser cached por alguns minutos
