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

GET https://api-get-leads.speedio.com.br/search_preview_leads

Parâmetros

Query Parameters

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

Exemplo de Requisição

curl -H "Authorization: Basic $(echo -n ${SPEEDIO_USERNAME}:${SPEEDIO_PASSWORD} | base64)" \
     -H "Content-Type: application/json" \
     "https://api-get-leads.speedio.com.br/search_preview_leads?cnpjs=%5B%2221071712000171%22%5D"

Resposta de Sucesso

{
  "empty_result": false,
  "applied_filters": {
    "cnae": {
      "cnae1.keyword": ["6203100"]
    },
    "locations_uf": {
      "sg_uf.keyword": ["ES"]
    },
    "range_faturamento": ["10M a 30M"],
    "range_funcionario": ["51 a 100"]
  },
  "metrics": {
    "total_emails": 25,
    "total_telephones": 18,
    "total_decision_makers": 12,
    "total_companies": 1,
    "count_companies": 1,
    "count_decision_makers": 12,
    "count_telephones": 18,
    "count_emails": 25
  }
}

Estrutura da Resposta

Campos Principais

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

Códigos de Status

StatusDescriçãoSolução
200✅ Sucesso - Preview geradoContinue com a busca completa se necessário
400❌ Parâmetros inválidosVerifique o formato do array de CNPJs
401❌ Não autorizadoVerifique suas credenciais de autenticação
429⚠️ Limite de taxa excedidoAguarde antes de fazer nova requisição
500❌ Erro interno do servidorTente 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
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