ArgorantDocs

Dein erster Aufruf

Der Schnellstart. Mit einem API-Schlüssel zählst du einen Markt, siehst dir die Personen an, schaltest ein paar frei, speicherst sie als Liste und bereitest eine Kampagne vor. Zählen und Ansehen sind kostenlos.

Du brauchst einen API-Schlüssel. Erstell einen unter app.argorant.com/profile bei API-Schlüssel. Er beginnt mit ag_live_ und wird nur einmal angezeigt. Jedes neue Konto bekommt eine 14-tägige Testphase mit 100 Credits und 300 Kampagnen-E-Mails, ohne Karte.

Shell
export ARGORANT_API_KEY=ag_live_...

Schlüssel prüfen

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

Du siehst deinen Plan, deine Credits, wie viele Anfragen pro Minute der Schlüssel senden darf und was von den heutigen Limits übrig ist.

Einen Markt zählen, kostenlos

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}

Unsicher, welche Begriffe du nehmen sollst? GET /api/v1/lookups/industries?q=soft und GET /api/v1/lookups/titles?q=head of liefern die genauen Namen und wie viele Personen jeweils dazu passen. Die Werte sind englisch, zum Beispiel Germany für Deutschland.

Ansehen, wer passt, kostenlos

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"

Jede Zeile zeigt Rolle, Firma und Ort, mit dem Namen als Initialen und ohne Kontaktdaten. Jede Zeile hat eine record_id.

Ein paar Personen freischalten

Das kostet Credits. Zeig in einer App oder einem Agenten also erst den Preis und frag nach.

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

Jede E-Mail wird direkt vor der Auslieferung geprüft. Du zahlst 1 Credit pro Person, deren E-Mail die Prüfung besteht, und nichts für den Rest. credits_charged zeigt, was es gekostet hat.

Die Suche als Liste speichern

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

Speichern ist kostenlos und schaltet niemanden frei. Merk dir die list_id.

Eine Kampagne vorbereiten

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

Die Kampagne startet als Entwurf. Nichts wird versendet, bis du sie startest. 200 Personen finden und anschreiben zeigt den Rest: die E-Mails, die Personen, die Postfächer und den Start.

Dieselben Schritte im Terminal: npx argorant count, npx argorant search, npx argorant reveal, npx argorant list create, npx argorant campaigns create. In Claude oder ChatGPT verbindest du https://mcp.argorant.com/mcp und fragst in normalen Worten.