Skip to main content

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

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

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": ["[email protected]", "[email protected]"]
    },
    "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

cnpj
string
CNPJ da empresa
razao_social
string
Razão social da empresa
nome_fantasia
string
Nome fantasia da empresa

Localização

location
object
Informações de localização da empresa

Informações Financeiras e Operacionais

website
string
Website oficial da empresa
faixa_faturamento_cnpj
string
Faixa de faturamento baseada no CNPJ
faixa_faturamento_empresa
string
Faixa de faturamento da empresa
qnt_funcionario_cnpj
string
Quantidade de funcionários baseada no CNPJ
qnt_funcionario_empresa
string
Quantidade de funcionários da empresa

Dados de Contato

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

Informações Societárias

qsa
array
Quadro Societário e Administrativo
administrador
string
Nome do administrador principal

Dados Legais e Cadastrais

data_abertura
string
Data de abertura da empresa (formato DD/MM/AAAA)
idade_empresa
string
Idade da empresa em formato legível
qnt_filiais
number
Quantidade de filiais
natureza_juridica
string
Código da natureza jurídica

CNAE (Atividades Econômicas)

cnae_primario
object
CNAE principal da empresa
cnae_secundario
array
Lista de CNAEs secundários da empresa (mesma estrutura do CNAE primário)

Códigos de Status

StatusDescriçãoSolução
200✅ Sucesso - Dados retornadosProcesse 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

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.

Próximos Passos