REST: POST /api/mcp/exports/create

Erstelle einen verifizierten CSV-Exportauftrag und bekomm eine Auftrags-ID zurück.

Exporte laufen asynchron. Du erstellst einen Auftrag, die Plattform verifiziert die Adressen und baut die CSV, dann lädst du sie herunter. Berechnet werden nur zustellbare Zeilen.

curl -X POST -H "Authorization: Bearer ag_live_..." \
  -H "Content-Type: application/json" \
  -d '{"limit": 1000, "filters": {"keywords": "logistics", "country": "Germany", "has_email": "true"}, "exclude_previously_exported": true}' \
  https://app.argorant.com/api/mcp/exports/create

Felder im Body

limit: maximale Zeilenzahl. Das ist die Ausgabengrenze für den Auftrag.
filters: dasselbe Filterobjekt wie bei Zählung und Vorschau. Die CLI setzt has_email standardmäßig auf true, damit exportierte Zeilen wirklich eine Adresse haben.
exclude_previously_exported: überspringt Kontakte, die dieses Konto schon exportiert hat. So bleiben aktualisierte Listen sauber.

Was zurückkommt

Ein normaler Auftrag: eine job_id plus Pfade für Status und Download.
Ein großer Auftrag über 50.000 Zeilen: stattdessen ein Batch, mit einer batch_id, der Zahl der Teile und einem Pfad für den Batch-Status. Jeder Teil wird als eigene Datei heruntergeladen.

JSON-Antwort der Exporterstellung mit einer Auftrags-ID

Frag den Status-Pfad ab, bis der Auftrag einen Endzustand meldet, und lade dann herunter. Der ganze Ablauf steht im Artikel zu Status und Download.

Die Verifizierung läuft in diesem Moment, nicht bei der Erfassung des Datensatzes. Adressen, die durchfallen, werden ausgeschlossen und kosten nichts, und Catch-all-Postfächer werden ehrlich gekennzeichnet, damit du entscheiden kannst, ob du sie einbeziehst.