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

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"

const username = process.env.SPEEDIO_USERNAME;
const password = process.env.SPEEDIO_PASSWORD;
const auth = Buffer.from(`${username}:${password}`).toString('base64');

const response = await fetch('https://api-get-leads.speedio.com.br/search_enriched_leads/decision_makers?cnpjs=["21071712000171"]', {
  method: 'GET',
  headers: {
    'Authorization': `Basic ${auth}`,
    'Content-Type': 'application/json'
  }
});

const data = await response.json();

import requests
import base64
import os

username = os.getenv('SPEEDIO_USERNAME')
password = os.getenv('SPEEDIO_PASSWORD')
auth = base64.b64encode(f"{username}:{password}".encode()).decode()

response = requests.get(
    'https://api-get-leads.speedio.com.br/search_enriched_leads/decision_makers',
    params={'cnpjs': '["21071712000171"]'},
    headers={
        'Authorization': f'Basic {auth}',
        'Content-Type': 'application/json'
    }
)

data = response.json()

$username = $_ENV['SPEEDIO_USERNAME'];
$password = $_ENV['SPEEDIO_PASSWORD'];
$auth = base64_encode($username . ':' . $password);

$response = file_get_contents('https://api-get-leads.speedio.com.br/search_enriched_leads/decision_makers?cnpjs=["21071712000171"]', false, stream_context_create([
    'http' => [
        'header' => [
            'Authorization: Basic ' . $auth,
            'Content-Type: application/json'
        ]
    ]
]));

$data = json_decode($response, true);

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": "sanderson.franca@speedio.com.br",
        "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": "jose@speedio.com.br",
        "location": "Manaus, Amazonas, Brasil",
        "position": "Board of Advisors",
        "email_response": "T",
        "department": "Outros"
      }
    ]
  }
]

Estrutura da Resposta

Informações da Empresa

string

CNPJ da empresa consultada

array

Lista de tomadores de decisão identificados na empresa

Dados dos Decision Makers

string

Nome completo do decision maker

string

Cargo/posição atual na empresa

string

Departamento ao qual pertenceValores possíveis: Comercial, TI, Gestão, Recursos Humanos, Operacional, Administrativo, Jurídico, Outros

string

Nível hierárquico do decision makerValores possíveis: Alto, Médio, Baixo, Não classificado

string

Localização geográfica do profissional

string

Nome da empresa onde trabalha

Informações de Contato

string

E-mail profissional validado (quando disponível)

string

Status da validação do e-mailValores possíveis: T (válido), F (inválido), null (não verificado)

Dados do LinkedIn

string

URL completa do perfil do LinkedIn

string

ID limpo do perfil do LinkedIn (para uso interno)

string

URN único do perfil no LinkedIn

Informações Profissionais

string

Resumo profissional extraído do perfil do LinkedIn

string

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 determinado

Departamentos 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.

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.

Começando

Autenticação

Endpoints da API

Guias

Buscar Tomadores de Decisão

Buscar Tomadores de Decisão

URL do Endpoint

Parâmetros

Query Parameters

Exemplo de Requisição

Resposta de Sucesso

Estrutura da Resposta

Informações da Empresa

Dados dos Decision Makers

Informações de Contato

Dados do LinkedIn

Informações Profissionais

Códigos de Status

Classificação por Nível

Alto

Médio

Baixo

Não Classificado

Departamentos Identificados

Casos de Uso

1. Vendas B2B Direcionadas

2. Account-Based Marketing

3. Mapeamento de Prospects

4. Enriquecimento de CRM

5. Análise Competitiva

Limites e Considerações

Próximos Passos

Buscar Dados da Empresa

Preview de Resultados

​Buscar Tomadores de Decisão

​URL do Endpoint

​Parâmetros

​Query Parameters

​Exemplo de Requisição

​Resposta de Sucesso

​Estrutura da Resposta

​Informações da Empresa

​Dados dos Decision Makers

​Informações de Contato

​Dados do LinkedIn

​Informações Profissionais

​Códigos de Status

​Classificação por Nível

​Alto

​Médio

​Baixo

​Não Classificado

​Departamentos Identificados

​Casos de Uso

​1. Vendas B2B Direcionadas

​2. Account-Based Marketing

​3. Mapeamento de Prospects

​4. Enriquecimento de CRM

​5. Análise Competitiva

​Limites e Considerações

​Próximos Passos

Buscar Dados da Empresa

Preview de Resultados

Buscar Tomadores de Decisão

URL do Endpoint

Parâmetros

Query Parameters

Exemplo de Requisição

Resposta de Sucesso

Estrutura da Resposta

Informações da Empresa

Dados dos Decision Makers

Informações de Contato

Dados do LinkedIn

Informações Profissionais

Códigos de Status

Classificação por Nível

Alto

Médio

Baixo

Não Classificado

Departamentos Identificados

Casos de Uso

1. Vendas B2B Direcionadas

2. Account-Based Marketing

3. Mapeamento de Prospects

4. Enriquecimento de CRM

5. Análise Competitiva

Limites e Considerações

Próximos Passos