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
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
Informações da Empresa
CNPJ da empresa consultada
Lista de tomadores de decisão identificados na empresa
Dados dos Decision Makers
Nome completo do decision maker
Cargo/posição atual na empresa
Departamento ao qual pertenceValores possíveis:
Comercial, TI, Gestão, Recursos Humanos, Operacional, Administrativo, Jurídico, OutrosNível hierárquico do decision makerValores possíveis:
Alto, Médio, Baixo, Não classificadoLocalização geográfica do profissional
Nome da empresa onde trabalha
Informações de Contato
E-mail profissional validado (quando disponível)
Status da validação do e-mailValores possíveis:
T (válido), F (inválido), null (não verificado)Dados do LinkedIn
URL completa do perfil do LinkedIn
ID limpo do perfil do LinkedIn (para uso interno)
URN único do perfil no LinkedIn
Informações Profissionais
Resumo profissional extraído do perfil do LinkedIn
Data e hora da última atualização dos dados (formato ISO 8601)
Códigos de Status
| Status | Descrição | Solução |
|---|---|---|
200 | ✅ Sucesso - Decision makers encontrados | Processe os dados da resposta |
400 | ❌ Parâmetros inválidos | Verifique o formato do array de CNPJs |
401 | ❌ Não autorizado | Verifique suas credenciais de autenticação |
404 | ❌ CNPJs não encontrados | Verifique se os CNPJs existem e estão corretos |
429 | ⚠️ Limite de taxa excedido | Aguarde antes de fazer nova requisição |
500 | ❌ Erro interno do servidor | Tente 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 determinadoDepartamentos Identificados
| Departamento | Descrição |
|---|---|
| Comercial | Vendas, Account Management, Customer Success |
| TI | Tecnologia, Desenvolvimento, Produto |
| Gestão | Liderança executiva, Diretoria |
| Recursos Humanos | RH, Recrutamento, People |
| Operacional | Operações, Logística, Produção |
| Administrativo | Administração, Finanças, Controladoria |
| Jurídico | Advocacia, Compliance, Legal |
| Outros | Departamentos 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.
