Obter Resultado

curl --request GET \
  --url 'https://api.enrow.io/email/find/single?id=0cf517bc-16e8-45bc-b967-ab9116b3c804' \
  --header 'x-api-key: YOUR_API_KEY'

const searchId = '0cf517bc-16e8-45bc-b967-ab9116b3c804';
const response = await fetch(`https://api.enrow.io/email/find/single?id=${searchId}`, {
  headers: {
    'x-api-key': process.env.ENROW_API_KEY
  }
});

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

import requests
import os

search_id = "0cf517bc-16e8-45bc-b967-ab9116b3c804"
url = f"https://api.enrow.io/email/find/single?id={search_id}"
headers = {
    "x-api-key": os.getenv("ENROW_API_KEY")
}

response = requests.get(url, headers=headers)
print(response.json())

{
  "email": "dwight.schrute@dundermifflin.com",
  "custom": {
    "external_id": "do4eIF8jF40x!",
    "partition_number": 2
  },
  "info": {
    "company_domain": "dundermifflin.com",
    "fullname": "Dwight Schrute",
    "firstname": "dwight",
    "lastname": "schrute"
  },
  "qualification": "valid"
}

{
  "message": "..."
}

GET

find

single

curl --request GET \
  --url 'https://api.enrow.io/email/find/single?id=0cf517bc-16e8-45bc-b967-ab9116b3c804' \
  --header 'x-api-key: YOUR_API_KEY'

const searchId = '0cf517bc-16e8-45bc-b967-ab9116b3c804';
const response = await fetch(`https://api.enrow.io/email/find/single?id=${searchId}`, {
  headers: {
    'x-api-key': process.env.ENROW_API_KEY
  }
});

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

import requests
import os

search_id = "0cf517bc-16e8-45bc-b967-ab9116b3c804"
url = f"https://api.enrow.io/email/find/single?id={search_id}"
headers = {
    "x-api-key": os.getenv("ENROW_API_KEY")
}

response = requests.get(url, headers=headers)
print(response.json())

{
  "email": "dwight.schrute@dundermifflin.com",
  "custom": {
    "external_id": "do4eIF8jF40x!",
    "partition_number": 2
  },
  "info": {
    "company_domain": "dundermifflin.com",
    "fullname": "Dwight Schrute",
    "firstname": "dwight",
    "lastname": "schrute"
  },
  "qualification": "valid"
}

{
  "message": "..."
}

GET

https://api.enrow.io/email/find/single?id={id}

Recupere o resultado de uma busca de email iniciada anteriormente usando seu ID único. Autentique cada requisição com sua chave de API no cabeçalho x-api-key.

Usar um webhook permite que você ignore a chamada a este endpoint GET, pois você será notificado no exato momento em que sua busca for concluída. Consulte Como Funcionam os Webhooks.

Parâmetros de Consulta

string

obrigatório

O identificador único retornado pela requisição POST

Resposta

200 — Busca concluída

string

O endereço de email descoberto

string

valid (email encontrado) ou invalid (email não encontrado). Por que binário?

number

Custo final da busca, já com os reembolsos: 1 para um email encontrado, 0 para um email não encontrado (0.25 para uma busca a partir da URL de um perfil do LinkedIn ou para uma conta com taxa de sucesso anormalmente baixa, veja Créditos e cobrança). Uma busca a partir da URL de um perfil do LinkedIn que falha por causa de um problema do nosso lado custa 0: veja Resultados de uma busca a partir da URL de um perfil do LinkedIn.

object

Informações de contato e da empresa. Em uma busca a partir da URL de um perfil do LinkedIn, só aparece quando um email é encontrado.

Mostrar propriedades de info

string

Domínio da empresa

string

Nome da empresa

string

Nome completo conforme fornecido na requisição

string

Primeiro nome

string

Sobrenome

string

Gênero (male ou female) — somente se retrieve_gender estiver definido como true

object

Propriedades personalizadas enviadas na requisição original, retornadas sem alterações

string

Apenas em uma busca a partir da URL de um perfil do LinkedIn. Como a busca terminou: found, profile_not_found, no_current_company, email_not_found ou lookup_failed. Veja Resultados de uma busca a partir da URL de um perfil do LinkedIn.

string

Apenas em uma busca a partir da URL de um perfil do LinkedIn. O linkedin_url que você enviou.

202 — Busca ainda em andamento

string

ongoing — a busca ainda não foi concluída. Consulte novamente em breve ou use um webhook para ser notificado automaticamente. Recuperar um resultado não consome créditos; consulte Créditos e cobrança.

Respostas de Erro

Code	Message
400	`The single search id is missing in the URL query string`
500	`Could not retrieve single search results`

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

Resultados de uma busca a partir da URL de um perfil do LinkedIn

Uma busca iniciada a partir da URL de um perfil do LinkedIn mantém a qualification binária e adiciona dois campos: linkedin_status, que indica como a busca terminou, e linkedin_url, a URL que você enviou.

`linkedin_status`	Significado	`qualification`	`credits_used`
`found`	O email profissional da pessoa foi encontrado e verificado	`valid`	`1`
`profile_not_found`	Nenhum perfil encontrado nesta URL do LinkedIn	`invalid`	`0.25`
`no_current_company`	O perfil não mostra nenhum cargo atual para fazer a busca	`invalid`	`0.25`
`email_not_found`	Perfil encontrado, mas nenhum email na empresa atual da pessoa	`invalid`	`0.25`
`lookup_failed`	A busca não pôde ser concluída por causa de um problema do nosso lado. Ela é totalmente reembolsada: tente novamente em alguns minutos	`invalid`	`0`

Quando o email é encontrado, info traz o nome e a empresa lidos no perfil: firstname, lastname, company_name e company_domain, além de gender quando retrieve_gender é true. Em todos os outros casos, a resposta não tem email nem info: ela nunca revela a quem pertence o perfil. Se o email ou o perfil estiver na sua lista de supressão, o email encontrado é retido: o resultado indica email_not_found e custa 1 crédito, como um email encontrado. Enquanto a busca está em andamento, o endpoint retorna o 202 habitual com qualification: "ongoing".

{
  "email": "dwight.schrute@dundermifflin.com",
  "custom": {
    "crm_id": "lead_001"
  },
  "info": {
    "company_domain": "dundermifflin.com",
    "company_name": "Dunder Mifflin",
    "firstname": "Dwight",
    "lastname": "Schrute"
  },
  "linkedin_status": "found",
  "linkedin_url": "https://www.linkedin.com/in/dwight-schrute",
  "qualification": "valid",
  "credits_used": 1
}

{
  "custom": {
    "crm_id": "lead_001"
  },
  "linkedin_status": "no_current_company",
  "linkedin_url": "https://www.linkedin.com/in/dwight-schrute",
  "qualification": "invalid",
  "credits_used": 0.25
}

curl --request GET \
  --url 'https://api.enrow.io/email/find/single?id=0cf517bc-16e8-45bc-b967-ab9116b3c804' \
  --header 'x-api-key: YOUR_API_KEY'

const searchId = '0cf517bc-16e8-45bc-b967-ab9116b3c804';
const response = await fetch(`https://api.enrow.io/email/find/single?id=${searchId}`, {
  headers: {
    'x-api-key': process.env.ENROW_API_KEY
  }
});

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

import requests
import os

search_id = "0cf517bc-16e8-45bc-b967-ab9116b3c804"
url = f"https://api.enrow.io/email/find/single?id={search_id}"
headers = {
    "x-api-key": os.getenv("ENROW_API_KEY")
}

response = requests.get(url, headers=headers)
print(response.json())

{
  "email": "dwight.schrute@dundermifflin.com",
  "custom": {
    "external_id": "do4eIF8jF40x!",
    "partition_number": 2
  },
  "info": {
    "company_domain": "dundermifflin.com",
    "fullname": "Dwight Schrute",
    "firstname": "dwight",
    "lastname": "schrute"
  },
  "qualification": "valid"
}

{
  "message": "..."
}

Próximos passos

Encontrar um email

Inicie uma busca individual de email para obter um id de busca.

Obter resultados em massa

Recupere os resultados de uma busca de email em massa.

Webhooks

Seja notificado automaticamente quando uma busca for concluída.

Autenticação

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

Primeiros passos

Email Finder

Email Verifier

Phone Finder

Conta

Parâmetros de Consulta

Resposta

200 — Busca concluída

202 — Busca ainda em andamento

Respostas de Erro

Resultados de uma busca a partir da URL de um perfil do LinkedIn

Próximos passos

Encontrar um email

Obter resultados em massa

Webhooks

Autenticação

​Parâmetros de Consulta

​Resposta

​200 — Busca concluída

​202 — Busca ainda em andamento

​Respostas de Erro

​Resultados de uma busca a partir da URL de um perfil do LinkedIn

​Próximos passos

Encontrar um email

Obter resultados em massa

Webhooks

Autenticação

Parâmetros de Consulta

Resposta

200 — Busca concluída

202 — Busca ainda em andamento

Respostas de Erro

Resultados de uma busca a partir da URL de um perfil do LinkedIn

Próximos passos