ArgorantDocs

Trova un'email

Dai il nome di una persona e il dominio aziendale, ricevi la sua email di lavoro. Una persona alla volta o fino a 10.000 persone, dall'API, dalla riga di comando, dal tuo assistente AI o dall'app.

Lo strumento Trova email prende un nome, un cognome e un dominio aziendale e restituisce l'email di lavoro della persona. Funziona allo stesso modo nell'app (Trova email nella barra laterale), nella REST API, dalla riga di comando e nei tool MCP.

Quanto costa

Paghi per ogni ricerca, in base a quello che torna, dagli stessi crediti di tutto il resto.

Cosa è tornatostatusPrezzo
Trovata e confermatavalid1 credito
Il dominio dell'azienda accetta qualsiasi indirizzo, quindi nessuno può essere confermato. Ricevi quello più probabile, segnato con confirmed: falsecatch_all1 credito
Non è stato trovato nullanot_found0,25 crediti
Input errato, un dominio senza email o un server di posta che al momento non era raggiungibile400, no_mail_domain, retry_laterGratis

Il quarto di credito viene da un piccolo saldo prepagato. La prima ricerca che non trova nulla prende 1 credito e tiene 0,75 per le tre successive. GET /api/v1/email-finder/pricing mostra i prezzi, il tuo saldo e i tuoi limiti.

Considera gli indirizzi catch_all come una buona ipotesi. Scrivi loro in numeri più piccoli e tieni d'occhio i rimbalzi.

Una persona

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." }

Ogni chiamata viene addebitata in base al proprio risultato. Non ripetere una ricerca che non ha trovato nulla; correggi prima il nome o il dominio. Funziona anche un nome completo: {"name": "Dr. Jane Doe", "domain": "acme.com"}.

Molte persone

Invia fino a 10.000 persone come rows o come testo CSV, con un limite di spesa:

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"}]}'

La risposta contiene il job_id e maximum_charge, il massimo che la lista può costare. Controlla il job circa ogni 30 secondi con GET /api/v1/email-finder/jobs/{job_id} e leggi le righe da .../results, oppure tutte insieme con .../results?format=csv.

Una lista si mette in pausa invece di fallire:

paused_reasonCosa è successoCosa fare
spend_limitHa raggiunto il tuo max_creditsRiprendi con un limite più alto
insufficient_creditsL'account ha finito i creditiAggiungi crediti, poi riprendi
daily_limitÈ stato raggiunto il limite giornaliero di ricercheNiente; riparte dopo la mezzanotte UTC
miss_rateLa maggior parte delle ricerche non ha trovato nulla, quindi ha rallentatoNiente; continua. Controlla i nomi e i domini

Riprendi con POST .../resume (facoltativamente {"max_credits": 150}) e ferma con POST .../cancel. Le righe mai cercate non vengono mai addebitate.

Le colonne CSV che funzionano sono first_name e last_name (oppure name o full_name), domain (oppure company_domain o website) e un id o ref facoltativo che torna insieme al risultato.

Limiti

30 ricerche singole al minuto e 2.000 ricerche al giorno per account. Un account le cui ricerche non trovano quasi mai nulla viene rallentato a 20 all'ora per un po'. Non gli viene mai addebitato di più. Oltre questi limiti ricevi 429 con finder_rate_limit, finder_daily_limit o finder_miss_rate_throttle.

Un account senza piano e senza crediti da un pacchetto trova fino a 10 nuove email al giorno, contate insieme a quelle mostrate e alle esportazioni. Dopo ricevi 429 daily_limit_reached.

Dal terminale

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

Da un assistente AI

Il server MCP ha argorant_find_email per una persona e argorant_find_emails per una lista (con un limite di spesa che devi impostare), più argorant_find_emails_status e argorant_manage_find_emails. Vedi Tool.

In questa pagina