Skip to main content

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

string
required
Array de CNPJs em formato JSON para busca. Exemplo: ["21071712000171", "12345678000195"]

Exemplo de Requisição

Resposta de Sucesso

Estrutura da Resposta

Campos Principais

boolean
Indica se a busca retornará resultados vazios
object
Filtros que serão aplicados na busca baseados nos CNPJs fornecidos
object
Métricas quantitativas dos resultados esperados

Códigos de Status

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
Importante: Este endpoint fornece apenas uma prévia. Para obter os dados completos, use os endpoints /search_enriched_leads/cnpj ou /search_enriched_leads/decision_makers.

Próximos Passos

Buscar Dados Completos por CNPJ

Execute a busca completa para obter informações detalhadas das empresas

Buscar Tomadores de Decisão

Obtenha informações sobre os decision makers das empresas