Buscar Leads Enriquecidos por CNPJ

Este endpoint retorna informações completas e enriquecidas sobre empresas brasileiras, incluindo dados cadastrais, financeiros, contatos e muito mais.

URL do Endpoint

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

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/cnpj?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/cnpj?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/cnpj',
    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/cnpj?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",
    "razao_social": "SPEED IO - SERVICOS ESPECIALIZADOS LTDA",
    "nome_fantasia": "SPEEDIO",
    "location": {
      "uf": "ES",
      "city": "Colatina",
      "bairro": "CENTRO",
      "cep": "29700010",
      "tipo_logradouro": "AVENIDA",
      "nome_rua": "GETULIO VARGAS",
      "numero": "196"
    },
    "website": "https://speedio.com.br/",
    "faixa_faturamento_cnpj": "10M a 30M",
    "faixa_faturamento_empresa": "10M a 30M",
    "qnt_funcionario_cnpj": "51 a 100",
    "qnt_funcionario_empresa": "51 a 100",
    "telefones": {
      "telefones_validados": [],
      "telefones_contador": [],
      "telefones_invalidos": ["11994154146, 1132803375, 11949141380, 1131631068"]
    },
    "generic_emails": {
      "emails_validados": [],
      "emails_contador": [],
      "emails_invalidos": ["diogo@speedio.com.br", "atendimento@speedio.com.br"]
    },
    "qsa": [
      {
        "name": "EDUARDO BRENNAND CAMPOS",
        "position": "Sócio"
      },
      {
        "name": "DIOGO NASCIMENTO PUBLIO PEREIRA",
        "position": "Sócio-Administrador"
      },
      {
        "name": "BRUNO RONEY GOMES BRUNO",
        "position": "Sócio"
      }
    ],
    "administrador": "EDUARDO BRENNAND CAMPOS",
    "data_abertura": "19/09/2014",
    "idade_empresa": "10 anos",
    "qnt_filiais": 0,
    "natureza_juridica": "2062",
    "cnae_primario": {
      "cnae": "6203100",
      "cnae_desc": "Desenvolvimento e licenciamento de programas de computador não-customizáveis"
    },
    "cnae_secundario": [
      {
        "cnae": "6491300",
        "cnae_desc": "Sociedades de fomento mercantil - factoring"
      },
      {
        "cnae": "7319002",
        "cnae_desc": "Promoção de vendas"
      }
    ]
  }
]

Estrutura da Resposta

Dados da Empresa

string

CNPJ da empresa

Razão social da empresa

string

Nome fantasia da empresa

Localização

object

Informações de localização da empresa

Show Dados de Localização

string

Unidade Federativa (estado)

string

Cidade

string

Bairro

string

Código postal

string

Tipo do logradouro (Rua, Avenida, etc.)

string

Nome da rua/avenida

string

Número do endereço

Informações Financeiras e Operacionais

string

Website oficial da empresa

string

Faixa de faturamento baseada no CNPJ

string

Faixa de faturamento da empresa

string

Quantidade de funcionários baseada no CNPJ

string

Quantidade de funcionários da empresa

Dados de Contato

object

Informações sobre telefones da empresa

Show Dados de Telefones

array

Lista de telefones validados

array

Contador de telefones processados

array

Lista de telefones identificados como inválidos

object

Informações sobre e-mails genéricos da empresa

Show Dados de E-mails

array

Lista de e-mails validados

array

Contador de e-mails processados

array

Lista de e-mails identificados como inválidos

Informações Societárias

array

Quadro Societário e Administrativo

Show Estrutura do QSA

string

Nome do sócio/administrador

string

Cargo/posição na empresa

string

Nome do administrador principal

Dados Legais e Cadastrais

string

Data de abertura da empresa (formato DD/MM/AAAA)

string

Idade da empresa em formato legível

number

Quantidade de filiais

string

Código da natureza jurídica

CNAE (Atividades Econômicas)

object

CNAE principal da empresa

Show Estrutura do CNAE

string

Código CNAE

string

Descrição da atividade econômica

array

Lista de CNAEs secundários da empresa (mesma estrutura do CNAE primário)

Códigos de Status

Status	Descrição	Solução
`200`	✅ Sucesso - Dados retornados	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

Casos de Uso

1. Enriquecimento de Base de Dados

Enriqueça sua base de clientes com informações detalhadas usando os CNPJs.

2. Prospecção B2B

Obtenha informações completas sobre empresas prospectadas para personalizar abordagens.

3. Análise de Mercado

Colete dados sobre empresas de um segmento específico para análises de mercado.

4. Validação de Informações

Valide e atualize informações existentes sobre empresas em seu CRM.

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
Qualidade dos Dados: Alguns campos podem estar vazios dependendo da disponibilidade

Importante: Nem todos os campos estarão preenchidos para todas as empresas. A disponibilidade dos dados varia conforme a empresa e as fontes disponíveis.

Começando

Autenticação

Endpoints da API

Guias

Buscar Leads Enriquecidos por CNPJ

Buscar Leads Enriquecidos por CNPJ

URL do Endpoint

Parâmetros

Query Parameters

Exemplo de Requisição

Resposta de Sucesso

Estrutura da Resposta

Dados da Empresa

Localização

Informações Financeiras e Operacionais

Dados de Contato

Informações Societárias

Dados Legais e Cadastrais

CNAE (Atividades Econômicas)

Códigos de Status

Casos de Uso

1. Enriquecimento de Base de Dados

2. Prospecção B2B

3. Análise de Mercado

4. Validação de Informações

Limites e Considerações

Próximos Passos

Buscar Tomadores de Decisão

Preview de Resultados

​Buscar Leads Enriquecidos por CNPJ

​URL do Endpoint

​Parâmetros

​Query Parameters

​Exemplo de Requisição

​Resposta de Sucesso

​Estrutura da Resposta

​Dados da Empresa

​Localização

​Informações Financeiras e Operacionais

​Dados de Contato

​Informações Societárias

​Dados Legais e Cadastrais

​CNAE (Atividades Econômicas)

​Códigos de Status

​Casos de Uso

​1. Enriquecimento de Base de Dados

​2. Prospecção B2B

​3. Análise de Mercado

​4. Validação de Informações

​Limites e Considerações

​Próximos Passos

Buscar Tomadores de Decisão

Preview de Resultados

Buscar Leads Enriquecidos por CNPJ

URL do Endpoint

Parâmetros

Query Parameters

Exemplo de Requisição

Resposta de Sucesso

Estrutura da Resposta

Dados da Empresa

Localização

Informações Financeiras e Operacionais

Dados de Contato

Informações Societárias

Dados Legais e Cadastrais

CNAE (Atividades Econômicas)

Códigos de Status

Casos de Uso

1. Enriquecimento de Base de Dados

2. Prospecção B2B

3. Análise de Mercado

4. Validação de Informações

Limites e Considerações

Próximos Passos