ArgorantDocs

Encontrar um e-mail

Você informa o nome e o domínio da empresa de uma pessoa e recebe o e-mail corporativo dela. Uma pessoa por vez ou até 10.000 pessoas, pela API, pela linha de comando, pela sua IA ou pelo app.

O localizador de e-mails recebe um nome, um sobrenome e um domínio da empresa e devolve o e-mail corporativo da pessoa. Ele funciona do mesmo jeito no app (Localizador de e-mails na barra lateral), na API REST, na linha de comando e nas ferramentas MCP.

Quanto custa

Você paga por consulta, de acordo com o resultado, com os mesmos créditos de todo o resto.

ResultadostatusPreço
Encontrado e confirmadovalid1 crédito
O domínio da empresa aceita qualquer endereço, então nenhum pode ser confirmado. Você recebe o mais provável, marcado com confirmed: falsecatch_all1 crédito
Nada encontradonot_found0,25 crédito
Dados inválidos, um domínio sem e-mail ou um servidor de e-mail que não pôde ser alcançado no momento400, no_mail_domain, retry_laterGrátis

O quarto de crédito sai de um pequeno saldo pré-pago. A primeira consulta sem resultado usa 1 crédito e guarda 0,75 para as três seguintes. GET /api/v1/email-finder/pricing mostra os preços, seu saldo e seus limites.

Trate endereços catch_all como um bom palpite. Envie para eles em volumes menores e acompanhe os bounces.

Uma pessoa

Shell
curl -X POST "https://app.argorant.com/api/v1/email-finder/find" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Idempotency-Key: find-jane-doe-acme" \
  -H "Content-Type: application/json" \
  -d '{"first_name": "Jane", "last_name": "Doe", "domain": "acme.com"}'
JSON
{ "status": "valid", "email": "jane.doe@acme.com", "confirmed": true, "confidence": 95, "credits_charged": 1,
  "message": "Found and confirmed jane.doe@acme.com. 1 credit charged." }

Cada chamada é cobrada pelo próprio resultado. Não repita uma consulta que não encontrou nada; corrija o nome ou o domínio antes. Um nome completo também funciona: {"name": "Dr. Jane Doe", "domain": "acme.com"}.

Muitas pessoas

Envie até 10.000 pessoas como rows ou como texto CSV, com um limite de gasto:

Shell
curl -X POST "https://app.argorant.com/api/v1/email-finder/jobs" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Idempotency-Key: q4-accounts-finder" \
  -H "Content-Type: application/json" \
  -d '{"name": "Q4 accounts", "max_credits": 100, "rows": [{"first_name": "Jane", "last_name": "Doe", "domain": "acme.com", "ref": "crm-1042"}]}'

A resposta traz o job_id e o maximum_charge, o máximo que a lista pode custar. Consulte o job a cada 30 segundos mais ou menos com GET /api/v1/email-finder/jobs/{job_id} e leia as linhas em .../results, ou todas de uma vez com .../results?format=csv.

Uma lista pausa em vez de falhar:

paused_reasonO que aconteceuO que fazer
spend_limitEla chegou ao seu max_creditsRetome com um limite maior
insufficient_creditsA conta ficou sem créditosAdicione créditos e retome
daily_limitO limite diário de consultas foi atingidoNada; ela continua depois da meia-noite UTC
miss_rateA maioria das consultas não encontrou nada, então ela ficou mais lentaNada; ela continua. Confira os nomes e os domínios

Retome com POST .../resume (opcionalmente {"max_credits": 150}) e pare com POST .../cancel. Linhas que nunca foram consultadas nunca são cobradas.

As colunas CSV aceitas são first_name e last_name (ou name ou full_name), domain (ou company_domain ou website) e, opcionalmente, um id ou ref que volta junto com o resultado.

Limites

30 consultas avulsas por minuto e 2.000 consultas por dia por conta. Uma conta cujas consultas quase nunca encontram nada fica limitada a 20 por hora durante um tempo. Ela nunca é cobrada a mais por isso. Acima desses limites você recebe 429 com finder_rate_limit, finder_daily_limit ou finder_miss_rate_throttle.

Uma conta sem plano e sem créditos de um pacote encontra até 10 e-mails novos por dia, contados junto com revelações e exportações. Depois disso você recebe 429 daily_limit_reached.

Pelo terminal

Shell
npx argorant find "Jane Doe" --domain acme.com
npx argorant find --file people.csv -o found.csv --max-credits 100
npx argorant find status <job_id>
npx argorant find pricing

Por um assistente de IA

O servidor MCP tem argorant_find_email para uma pessoa e argorant_find_emails para uma lista (com um limite de gasto que você precisa definir), além de argorant_find_emails_status e argorant_manage_find_emails. Veja Ferramentas.

Nesta página