ArgorantDocs

Encontrar un correo

Con el nombre de una persona y el dominio de su empresa, obtienes su correo corporativo. De uno en uno o hasta 10.000 personas, desde la API, la línea de comandos, tu IA o la app.

El buscador de correos toma un nombre, un apellido y un dominio de empresa y devuelve el correo corporativo de la persona. Funciona igual en la app (Buscador de correos en la barra lateral), la API REST, la línea de comandos y las herramientas MCP.

Cuánto cuesta

Pagas por búsqueda, según lo que se devuelve, con los mismos créditos que todo lo demás.

Qué se devolvióstatusPrecio
Encontrado y confirmadovalid1 crédito
El dominio de la empresa acepta cualquier dirección, así que no se puede confirmar ninguna. Recibes la más probable, marcada con confirmed: falsecatch_all1 crédito
No se encontró nadanot_found0,25 créditos
Datos de entrada incorrectos, un dominio sin correo o un servidor de correo al que no se pudo llegar en ese momento400, no_mail_domain, retry_laterGratis

El cuarto de crédito sale de un pequeño saldo prepagado. La primera búsqueda que no encuentra nada toma 1 crédito y guarda 0,75 para las tres siguientes. GET /api/v1/email-finder/pricing muestra los precios, tu saldo y tus límites.

Trata las direcciones catch_all como una buena suposición. Envíales correos en cantidades más pequeñas y vigila los rebotes.

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

Cada llamada se cobra según su propio resultado. No repitas una búsqueda que no encontró nada; corrige antes el nombre o el dominio. También funciona un nombre completo: {"name": "Dr. Jane Doe", "domain": "acme.com"}.

Muchas personas

Envía hasta 10.000 personas como rows o como texto CSV, con un límite 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"}]}'

La respuesta incluye el job_id y maximum_charge, lo máximo que puede costar la lista. Consulta el trabajo más o menos cada 30 segundos con GET /api/v1/email-finder/jobs/{job_id} y lee las filas desde .../results, o todas de una vez con .../results?format=csv.

Una lista se pausa en lugar de fallar:

paused_reasonQué pasóQué hacer
spend_limitAlcanzó tu max_creditsReanúdala con un límite más alto
insufficient_creditsLa cuenta se quedó sin créditosAñade créditos y reanúdala
daily_limitSe alcanzó el límite diario de búsquedasNada; sigue después de la medianoche UTC
miss_rateLa mayoría de las búsquedas no encontró nada, así que fue más despacioNada; sigue adelante. Revisa los nombres y los dominios

Reanuda con POST .../resume (opcionalmente {"max_credits": 150}) y detén con POST .../cancel. Las filas que nunca se buscaron nunca se cobran.

Las columnas CSV que funcionan son first_name y last_name (o name o full_name), domain (o company_domain o website) y un id o ref opcional que vuelve con el resultado.

Límites

30 búsquedas individuales por minuto y 2.000 búsquedas al día por cuenta. Una cuenta cuyas búsquedas casi nunca encuentran nada se frena a 20 por hora durante un tiempo. Nunca se le cobra más. Por encima de estos límites recibes 429 con finder_rate_limit, finder_daily_limit o finder_miss_rate_throttle.

Una cuenta sin plan y sin créditos de un paquete encuentra hasta 10 correos nuevos al día, contados junto con los desbloqueos y las exportaciones. Después recibes 429 daily_limit_reached.

Desde la 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

Desde un asistente de IA

El servidor MCP tiene argorant_find_email para una persona y argorant_find_emails para una lista (con un límite de gasto que debes fijar), además de argorant_find_emails_status y argorant_manage_find_emails. Consulta Herramientas.

En esta página