Skip to main content

Buscar Tomadores de Decisão

Este endpoint retorna informações detalhadas sobre os tomadores de decisão (decision makers) das empresas, incluindo perfis profissionais, contatos e dados do LinkedIn.

URL do Endpoint

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

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_enriched_leads/decision_makers?cnpjs=%5B%2221071712000171%22%5D"

Resposta de Sucesso

[
  {
    "cnpj": "21071712000171",
    "decision_makers": [
      {
        "summary": "Profissional comercial com mais de 5 anos de experiência. Especialista em atendimento, vendas e planejamento, com destaque em alcançar metas e gerar feedbacks positivos.",
        "level": "Alto",
        "last_update_datetime": "2025-07-01T16:55:38.197-03:00",
        "lkd_url": "https://linkedin.com/in/ACwAAErf9sEBBerfCREVFf-b6BcWgp5BpQl_368",
        "entityUrn": "urn:li:fs_salesProfile:(ACwAAErf9sEBBerfCREVFf-b6BcWgp5BpQl_368,NAME_SEARCH,GKqI)",
        "company_name": "Speedio",
        "clean_lkd_url": "ACwAAErf9sEBBerfCREVFf-b6BcWgp5BpQl_368",
        "name": "Sanderson França",
        "mchecker_email": "[email protected]",
        "location": "São Paulo, Brasil",
        "position": "Executivo de vendas",
        "email_response": "T",
        "department": "Comercial"
      },
      {
        "summary": "Engenheiro de Produção pela Unesp, Especialista em Negócios Internacionais pela OTH-Regensburg, Pós-graduado em Administração de Empresas e MBA em Gestão de Projetos.",
        "level": "Alto",
        "last_update_datetime": "2025-07-01T16:55:38.200-03:00",
        "lkd_url": "https://linkedin.com/in/ACwAAArDBR0BIYPJl9f-tJz5ClJ_RCEio3F3J6E",
        "entityUrn": "urn:li:fs_salesProfile:(ACwAAArDBR0BIYPJl9f-tJz5ClJ_RCEio3F3J6E,NAME_SEARCH,g24O)",
        "company_name": "Speedio",
        "clean_lkd_url": "ACwAAArDBR0BIYPJl9f-tJz5ClJ_RCEio3F3J6E",
        "name": "José Rubens Urbini Junior",
        "mchecker_email": "[email protected]",
        "location": "Manaus, Amazonas, Brasil",
        "position": "Board of Advisors",
        "email_response": "T",
        "department": "Outros"
      }
    ]
  }
]

Estrutura da Resposta

Informações da Empresa

cnpj
string
CNPJ da empresa consultada
decision_makers
array
Lista de tomadores de decisão identificados na empresa

Dados dos Decision Makers

name
string
Nome completo do decision maker
position
string
Cargo/posição atual na empresa
department
string
Departamento ao qual pertenceValores possíveis: Comercial, TI, Gestão, Recursos Humanos, Operacional, Administrativo, Jurídico, Outros
level
string
Nível hierárquico do decision makerValores possíveis: Alto, Médio, Baixo, Não classificado
location
string
Localização geográfica do profissional
company_name
string
Nome da empresa onde trabalha

Informações de Contato

mchecker_email
string
E-mail profissional validado (quando disponível)
email_response
string
Status da validação do e-mailValores possíveis: T (válido), F (inválido), null (não verificado)

Dados do LinkedIn

lkd_url
string
URL completa do perfil do LinkedIn
clean_lkd_url
string
ID limpo do perfil do LinkedIn (para uso interno)
entityUrn
string
URN único do perfil no LinkedIn

Informações Profissionais

summary
string
Resumo profissional extraído do perfil do LinkedIn
last_update_datetime
string
Data e hora da última atualização dos dados (formato ISO 8601)

Códigos de Status

StatusDescriçãoSolução
200✅ Sucesso - Decision makers encontradosProcesse os dados da resposta
400❌ Parâmetros inválidosVerifique o formato do array de CNPJs
401❌ Não autorizadoVerifique suas credenciais de autenticação
404❌ CNPJs não encontradosVerifique se os CNPJs existem e estão corretos
429⚠️ Limite de taxa excedidoAguarde antes de fazer nova requisição
500❌ Erro interno do servidorTente novamente ou contate o suporte

Classificação por Nível

Alto

  • C-Level: CEO, CTO, CFO, CMO
  • Diretores: Executivos seniores
  • VPs: Vice-presidentes
  • Sócios: Proprietários/sócios

Médio

  • Gerentes: Gerentes de área
  • Coordenadores: Coordenadores de equipe
  • Supervisores: Supervisores de setor

Baixo

  • Analistas: Analistas seniores
  • Especialistas: Especialistas técnicos
  • Assistentes: Assistentes de liderança

Não Classificado

Profissionais cujo nível hierárquico não foi determinado

Departamentos Identificados

DepartamentoDescrição
ComercialVendas, Account Management, Customer Success
TITecnologia, Desenvolvimento, Produto
GestãoLiderança executiva, Diretoria
Recursos HumanosRH, Recrutamento, People
OperacionalOperações, Logística, Produção
AdministrativoAdministração, Finanças, Controladoria
JurídicoAdvocacia, Compliance, Legal
OutrosDepartamentos não categorizados

Casos de Uso

1. Vendas B2B Direcionadas

Identifique os decision makers certos para suas propostas comerciais.

2. Account-Based Marketing

Personalize campanhas focando nos tomadores de decisão específicos.

3. Mapeamento de Prospects

Entenda a estrutura organizacional das empresas-alvo.

4. Enriquecimento de CRM

Adicione informações detalhadas sobre contatos no seu CRM.

5. Análise Competitiva

Identifique profissionais-chave em empresas concorrentes.

Limites e Considerações

  • Rate Limit: 100 requisições por minuto
  • CNPJs por Requisição: Até 100 CNPJs
  • Dados Atualizados: Informações são atualizadas regularmente
  • Disponibilidade: Nem todas as empresas terão decision makers identificados
Qualidade dos Dados: As informações são extraídas de perfis públicos do LinkedIn e outras fontes. A disponibilidade e qualidade variam conforme a empresa e a atividade dos profissionais na plataforma.
Importante: Respeite sempre as políticas de privacidade e termos de uso ao utilizar informações de contato. Use os dados de forma ética e em conformidade com a LGPD.

Próximos Passos