ArgorantDocs

Tu primera llamada

El inicio rápido. Con una sola clave de API cuentas un mercado, ves a las personas, desbloqueas algunas, las guardas como lista y preparas una campaña. Contar y mirar es gratis.

Necesitas una clave de API. Créala en app.argorant.com/profile, en Claves de API. Empieza por ag_live_ y solo se muestra una vez. Cada cuenta nueva recibe una prueba de 7 días con 100 créditos y 300 correos de campaña.

Shell
export ARGORANT_API_KEY=ag_live_...

Comprueba la clave

Shell
curl "https://app.argorant.com/api/v1/account" -H "Authorization: Bearer $ARGORANT_API_KEY"

Ves tu plan, tus créditos, cuántas solicitudes por minuto puede enviar la clave y cuánto te queda de los límites de hoy.

Cuenta un mercado, gratis

Shell
curl -G "https://app.argorant.com/api/v1/people/count" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" \
  --data-urlencode "title=CFO" --data-urlencode "country=Germany" --data-urlencode "employee_range=51-200"
# {"count": 4210}

¿No sabes qué palabras usar? GET /api/v1/lookups/industries?q=soft y GET /api/v1/lookups/titles?q=head of te dan los nombres exactos y cuántas personas tiene cada uno.

Mira quién encaja, gratis

Shell
curl -G "https://app.argorant.com/api/v1/people/search" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" \
  --data-urlencode "title=CFO" --data-urlencode "country=Germany" --data-urlencode "employee_range=51-200" --data-urlencode "limit=10"

Cada fila muestra el cargo, la empresa y el lugar, con el nombre reducido a iniciales y sin datos de contacto. Cada fila tiene un record_id.

Desbloquea a algunas personas

Esto gasta créditos, así que en una app o un agente muestra el precio y pregunta antes.

Shell
curl -X POST "https://app.argorant.com/api/v1/people/reveal" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" \
  -H "Idempotency-Key: first-reveal-1" \
  -H "Content-Type: application/json" \
  -d '{"title":"CFO","country":"Germany","employee_range":"51-200","limit":5}'

Cada correo se comprueba justo antes de que lo recibas. Pagas 1 crédito por cada persona cuyo correo pasa la comprobación y nada por el resto. credits_charged indica lo que ha costado.

Guarda la búsqueda como lista

Shell
curl -X POST "https://app.argorant.com/api/v1/lists" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" \
  -H "Idempotency-Key: first-list-1" \
  -H "Content-Type: application/json" \
  -d '{"name":"CFOs Germany 51-200","filters":{"title":"CFO","country":"Germany","employee_range":"51-200"}}'

Guardar es gratis y no desbloquea a nadie. Guarda el list_id.

Prepara una campaña

Shell
curl -X POST "https://app.argorant.com/api/v1/campaigns" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Idempotency-Key: first-campaign-1" \
  -H "Content-Type: application/json" -d '{"name":"CFOs Germany Q4","daily_limit":40}'

La campaña empieza como borrador. No se envía nada hasta que la lances. Encontrar a 200 personas y escribirles muestra el resto: los correos, las personas, los buzones y el lanzamiento.

Los mismos pasos en la terminal: npx argorant count, npx argorant search, npx argorant reveal, npx argorant list create, npx argorant campaigns create. En Claude o ChatGPT, conecta https://mcp.argorant.com/mcp y pídelo con tus propias palabras.

En esta página