Encontrar Email

curl --request POST \
  --url https://api.enrow.io/email/find/single \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "fullname": "Dwight Schrute",
    "company_domain": "dundermifflin.com",
    "settings": {
      "retrieve_gender": true
    }
  }'

const response = await fetch('https://api.enrow.io/email/find/single', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': process.env.ENROW_API_KEY
  },
  body: JSON.stringify({
    fullname: 'Dwight Schrute',
    company_domain: 'dundermifflin.com',
    settings: {
      retrieve_gender: true
    }
  })
});

const data = await response.json();
console.log(data.id);

import requests
import os

url = "https://api.enrow.io/email/find/single"
headers = {
    "Content-Type": "application/json",
    "x-api-key": os.getenv("ENROW_API_KEY")
}
payload = {
    "fullname": "Dwight Schrute",
    "company_domain": "dundermifflin.com",
    "settings": {
        "retrieve_gender": True
    }
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "message": "Single search operating",
  "id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
  "credits_used": 1
}

{
  "message": "..."
}

POST

find

single

curl --request POST \
  --url https://api.enrow.io/email/find/single \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "fullname": "Dwight Schrute",
    "company_domain": "dundermifflin.com",
    "settings": {
      "retrieve_gender": true
    }
  }'

const response = await fetch('https://api.enrow.io/email/find/single', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': process.env.ENROW_API_KEY
  },
  body: JSON.stringify({
    fullname: 'Dwight Schrute',
    company_domain: 'dundermifflin.com',
    settings: {
      retrieve_gender: true
    }
  })
});

const data = await response.json();
console.log(data.id);

import requests
import os

url = "https://api.enrow.io/email/find/single"
headers = {
    "Content-Type": "application/json",
    "x-api-key": os.getenv("ENROW_API_KEY")
}
payload = {
    "fullname": "Dwight Schrute",
    "company_domain": "dundermifflin.com",
    "settings": {
        "retrieve_gender": True
    }
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "message": "Single search operating",
  "id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
  "credits_used": 1
}

{
  "message": "..."
}

POST

https://api.enrow.io/email/find/single

Execute uma única busca de email para encontrar um endereço de email profissional. Autentique cada requisição com sua chave de API no cabeçalho x-api-key. Para operações em lote, use o endpoint Encontrar Emails (até 5.000 buscas por lote). A busca precisa de uma destas duas opções:

Um nome completo e uma empresa: fullname + (company_domain ou company_name)
A URL do perfil do LinkedIn de uma pessoa em linkedin_url (veja Busca a partir da URL de um perfil do LinkedIn)

Se as duas estiverem presentes, a busca usa o nome e a empresa.

A Enrow realiza verificações determinísticas que validam até mesmo emails catch-all. Isso significa que não é necessário passar os emails encontrados por um debouncer posteriormente.

Corpo da Requisição

string

O nome completo da pessoa para a qual encontrar o emailNota: Obrigatório em uma busca por nome + empresa, mas não em uma busca a partir de linkedin_url.

string

O domínio da empresa, vários formatos são aceitos ("dundermifflin.com", "https://www.dundermifflin.com"…)Nota: Em uma busca por nome + empresa, é obrigatório informar company_domain ou company_name.

string

O nome da empresa ("Apple", "Air France", …)Nota: Em uma busca por nome + empresa, é obrigatório informar company_domain ou company_name.

string

A URL do perfil do LinkedIn da pessoa ("https://www.linkedin.com/in/dwight-schrute"), para buscar a partir do perfil em vez de um nome e uma empresa. Veja Busca a partir da URL de um perfil do LinkedIn.Nota: Este campo só é usado quando a requisição não é uma busca completa por nome + empresa. Com um fullname e uma empresa, linkedin_url é ignorado.

object

Parâmetros personalizados que serão retornados na resposta GET e na notificação do webhook.

Mostrar objeto custom

string

padrão:"your_custom_property"

Seus dados personalizados

object

Um conjunto de configurações relacionadas a esta busca

Mostrar propriedades de settings

string

Uma URL que será notificada por meio de uma requisição HTTP POST assim que a busca única for concluída. Veja Como Funcionam os Webhooks.

string

padrão:"US"

O código ISO 3166 Alpha-2 do país relacionado à busca. Relevante ao usar um nome de empresa — ajuda a desambiguar homônimos pesquisando no Google localizado.

boolean

padrão:"false"

Permite obter o gênero (male/female) da pessoa.

Resposta

200 — Busca iniciada

string

Mensagem de confirmação

string

Identificador único desta busca. Use-o para recuperar os resultados pelo endpoint GET.

number

Número de créditos consumidos. Veja Créditos e faturamento para custos por endpoint.

Respostas de Erro

Código	Mensagem
400	`invalid JSON input`
400	`both company_domain and company_name are absent, input payload needs at least one of them`
400	`missing fullname`
400	`invalid linkedin_url format`
400	`LinkedIn email search is suspended for this account`
401	`No apikey found in the x-api-key headers`
401	`This apikey is not valid`
402	`Insufficient credits`

Respostas de créditos insuficientes (402) nos endpoints únicos retornam { "reason": "...", "success": false }; todos os outros erros retornam { "message": "..." }.

Veja Tratamento de erros para a lista completa de códigos de status e formatos de resposta.

Busca a partir da URL de um perfil do LinkedIn

Envie a URL do perfil do LinkedIn de uma pessoa em linkedin_url, em vez de um nome completo e uma empresa. A Enrow lê o perfil, identifica a empresa atual da pessoa e, em seguida, encontra e verifica o email profissional dela nessa empresa. A busca funciona como qualquer outra busca individual: a resposta 200 traz o id da busca, e o resultado chega pelo endpoint GET ou pelo seu webhook. custom e settings funcionam da mesma forma.

A busca a partir da URL de um perfil do LinkedIn funciona apenas para buscas individuais e pode não estar disponível em todas as contas. Se a sua conta não tiver esse recurso, uma requisição apenas com linkedin_url recebe o erro de validação habitual, como missing fullname. Se precisar dele, entre em contato com api@enrow.io.

Quando a busca usa o perfil?

A busca usa o perfil quando linkedin_url é informado e a requisição não é uma busca completa por nome + empresa:

fullname está ausente, vazio ou tem um único caractere, ou
nem company_domain nem company_name são informados.

Uma requisição com um fullname e uma empresa continua sendo uma busca por nome + empresa, mesmo com um linkedin_url. Quando a busca usa o perfil, o nome e a empresa vêm do perfil: um fullname, company_domain ou company_name enviado junto é ignorado.

Quais URLs são aceitas?

Formato	Exemplo
URL pública do perfil	`https://www.linkedin.com/in/dwight-schrute`
Sem `https://` ou `www.`, com barra no final ou parâmetros de consulta	`linkedin.com/in/dwight-schrute/?trk=people-guest`
Subdomínio de país	`https://fr.linkedin.com/in/dwight-schrute`
URL do perfil com um ID de membro	`https://www.linkedin.com/in/ACoAAB2xY3ZaBcD`
URL de lead ou de pessoa do Sales Navigator	`https://www.linkedin.com/sales/lead/ACwAAB2xY3ZaBcD,NAME_SEARCH,a1b2`

Qualquer outro valor é recusado com um 400 e a mensagem invalid linkedin_url format: uma página de empresa (linkedin.com/company/...), um link curto lnkd.in, uma página fora do linkedin.com ou um nome de perfil sem a URL.

Como a Enrow escolhe a empresa?

A Enrow procura o email na empresa atual da pessoa, conforme aparece no perfil. Quando há vários cargos atuais, ela usa o primeiro da lista. Entradas que não são um empregador, como autônomo, freelancer ou estudante, são ignoradas. Um perfil sem nenhum cargo atual em um empregador encerra a busca com no_current_company.

Quanto custa?

Iniciar a busca consome 1 crédito, como em qualquer busca (credits_used: 1 na resposta). Quando ela termina, a diferença é reembolsada: a busca custa 1 crédito quando um email é encontrado, 0,25 crédito quando nenhum é encontrado e nada quando falha por causa de um problema do nosso lado. O resultado informa o motivo em linkedin_status e o custo final em credits_used. Veja Créditos e cobrança.

Exemplo

curl --request POST \
  --url https://api.enrow.io/email/find/single \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "linkedin_url": "https://www.linkedin.com/in/dwight-schrute",
    "custom": {
      "crm_id": "lead_001"
    }
  }'

const response = await fetch('https://api.enrow.io/email/find/single', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': process.env.ENROW_API_KEY
  },
  body: JSON.stringify({
    linkedin_url: 'https://www.linkedin.com/in/dwight-schrute',
    custom: {
      crm_id: 'lead_001'
    }
  })
});

const data = await response.json();
console.log(data.id);

import requests
import os

url = "https://api.enrow.io/email/find/single"
headers = {
    "Content-Type": "application/json",
    "x-api-key": os.getenv("ENROW_API_KEY")
}
payload = {
    "linkedin_url": "https://www.linkedin.com/in/dwight-schrute",
    "custom": {
        "crm_id": "lead_001"
    }
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

A resposta é a mesma de uma busca por nome + empresa:

{
  "message": "Single search operating",
  "id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
  "credits_used": 1
}

curl --request POST \
  --url https://api.enrow.io/email/find/single \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "fullname": "Dwight Schrute",
    "company_domain": "dundermifflin.com",
    "settings": {
      "retrieve_gender": true
    }
  }'

const response = await fetch('https://api.enrow.io/email/find/single', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': process.env.ENROW_API_KEY
  },
  body: JSON.stringify({
    fullname: 'Dwight Schrute',
    company_domain: 'dundermifflin.com',
    settings: {
      retrieve_gender: true
    }
  })
});

const data = await response.json();
console.log(data.id);

import requests
import os

url = "https://api.enrow.io/email/find/single"
headers = {
    "Content-Type": "application/json",
    "x-api-key": os.getenv("ENROW_API_KEY")
}
payload = {
    "fullname": "Dwight Schrute",
    "company_domain": "dundermifflin.com",
    "settings": {
        "retrieve_gender": True
    }
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "message": "Single search operating",
  "id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
  "credits_used": 1
}

{
  "message": "..."
}

Próximos passos

Obter o resultado

Recupere o email encontrado usando o id da busca.

Encontrar emails em lote

Execute até 5.000 buscas de email em uma única requisição.

Autenticação

Como passar sua chave de API no cabeçalho x-api-key.

Webhooks

Seja notificado automaticamente quando uma busca for concluída.

Primeiros passos

Email Finder

Email Verifier

Phone Finder

Conta

Corpo da Requisição

Resposta

200 — Busca iniciada

Respostas de Erro

Busca a partir da URL de um perfil do LinkedIn

Quando a busca usa o perfil?

Quais URLs são aceitas?

Como a Enrow escolhe a empresa?

Quanto custa?

Exemplo

Próximos passos

Obter o resultado

Encontrar emails em lote

Autenticação

Webhooks

​Corpo da Requisição

​Resposta

​200 — Busca iniciada

​Respostas de Erro

​Busca a partir da URL de um perfil do LinkedIn

​Quando a busca usa o perfil?

​Quais URLs são aceitas?

​Como a Enrow escolhe a empresa?

​Quanto custa?

​Exemplo

​Próximos passos

Obter o resultado

Encontrar emails em lote

Autenticação

Webhooks

Corpo da Requisição

Resposta

200 — Busca iniciada

Respostas de Erro

Busca a partir da URL de um perfil do LinkedIn

Quando a busca usa o perfil?

Quais URLs são aceitas?

Como a Enrow escolhe a empresa?

Quanto custa?

Exemplo

Próximos passos