Saltar para o conteúdo principal
POST
/
email
/
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
    }
  }'
{
  "message": "Single search operating",
  "id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
  "credits_used": 1
}
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 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

fullname
string
obrigatório
O nome completo da pessoa para a qual encontrar o email
company_domain
string
O domínio da empresa, vários formatos são aceitos ("dundermifflin.com", "https://www.dundermifflin.com"…)Nota: É obrigatório informar company_domain ou company_name.
company_name
string
O nome da empresa ("Apple", "Air France", …)Nota: É obrigatório informar company_domain ou company_name.
custom
object
Parâmetros personalizados que serão retornados na resposta GET e na notificação do webhook.
settings
object
Um conjunto de configurações relacionadas a esta busca

Resposta

200 — Busca iniciada

message
string
Mensagem de confirmação
id
string
Identificador único desta busca. Use-o para recuperar os resultados pelo endpoint GET.
credits_used
number
Número de créditos consumidos. Veja Créditos e faturamento para custos por endpoint.

Respostas de Erro

CódigoMensagem
400invalid JSON input
400both company_domain and company_name are absent, input payload needs at least one of them
400missing fullname
401No apikey found in the x-api-key headers
401This apikey is not valid
402Insufficient 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.
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
    }
  }'
{
  "message": "Single search operating",
  "id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
  "credits_used": 1
}

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.