API REFERENCE

Desenvolvedores & Integrações

Integre nossa infraestrutura de dados de leads diretamente ao seu CRM, ERP ou sistema interno usando nossa REST API segura e simples de usar.

Autenticação

Todas as solicitações de API exigem a inclusão da chave de acesso do desenvolvedor no cabeçalho HTTP Authorization.

Authorization: Bearer SUA_API_KEY

Obter Leads por CNPJ

Consulte dados enriquecidos e validados de um lead a partir de seu CNPJ ativo.

POST /v1/leads/lookup

Parâmetro	Tipo	Requerido	Descrição
cnpj	String	Sim	CNPJ da empresa sem formatação (somente números).
enrich	Boolean	Não	Se verdadeiro, busca os perfis de redes sociais públicos associados.

Webhooks em Tempo Real

Receba notificações instantâneas no seu endpoint sempre que novas extrações em lote forem finalizadas.

Evento Disponível

leads.batch.completed

Exemplos de Código

Veja abaixo como realizar a requisição básica em cURL.

Requisição (cURL)

curl -X POST "https://api.acheimeulead.com.br/v1/leads/lookup" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "cnpj": "12345678000199",
    "enrich": true
  }'