REST: Endpunkte für Listen

Eine gefilterte Liste speichern und später ihre Größe prüfen. Beides kostenlos.

Eine gespeicherte Liste speichert Filter, keine eingefrorene Momentaufnahme. Öffnest du sie später, zeigt sie den aktuellen Markt. Eine anzulegen ist kostenlos und schaltet nichts frei: Der Server zählt die Treffer selbst, die Liste meldet also sofort ihre echte Größe.

Anlegen

curl -X POST -H "Authorization: Bearer ag_live_..." \
  -H "Content-Type: application/json" \
  -d '{"name": "DACH CFOs 200+", "filters": {"title": "CFO", "country": "DACH"}, "record_type": "person", "selection_mode": "filtered"}' \
  https://app.argorant.com/api/mcp/lists/create

Die Antwort enthält die ID der neuen Liste, ihren Namen und die aktuelle Gesamtzahl, also wie viele Kontakte gerade passen.

Status

GET /api/mcp/lists/{list_id}

Liefert Namen, aktuelle Größe, Auswahlmodus und Datensatztyp der Liste. Die ID ist numerisch. Prüf sie also vor dem Aufruf, wenn sie aus einer Benutzereingabe stammt.

Antwort der Listenerstellung mit der Listen-ID und ihrer Trefferzahl

CLI-Gegenstück

npx argorant list create --name "DACH CFOs 200+" --title CFO --country DACH
npx argorant list status 42

Das Muster, das funktioniert: eine Liste pro Segment, ihre Größe regelmäßig prüfen, um zu sehen, wie sich ein Markt bewegt, und bei jedem Kampagnenstart einen frischen Ausschnitt exportieren. Weil die Liste aus Filtern besteht, spiegelt der Export immer den Markt von heute, mit neuen Firmen und Führungskräften, die gewechselt haben.