Finden, speichern und exportieren

Die Filter, die jede Suche teilt, gespeicherte Listen, CSV-Exporte, Telefonnummern und Anreicherung, und was jedes davon kostet.

Filter

Zählen, Suchen, Freischalten, Listen, Exporte und Kampagnen nutzen alle dieselben Filter. Die Wortlisten (Referenz auf Englisch) liefern die genauen Namen für Branchen, Länder, Stichwörter, Technologien und Jobtitel und wie viele Personen jeweils dazu passen.

Filter	Beispiel	So funktioniert er
`q`	`software companies selling to restaurants`	Normale Wörter, gesucht in Name, Jobtitel, Firma und Beschreibung
`title`	`CFO, Finance Director`	Ein Komma heißt oder. Kennt Abkürzungen. `exclude_title` lässt Jobtitel weg
`seniority`	`C-Level,VP`	Owner, Founder, Partner, C-Level, VP, Director (passt auch auf Head of), Manager, Senior, Entry, Intern
`departments`	`Finance`
`industries`	`Software Development`	Genaue Namen aus der Branchenliste, ein senkrechter Strich heißt oder
`keywords`	`logistics, freight`	Wörter, die beschreiben, was die Firma macht: Name, Tags, Branche und Beschreibung. Der breiteste Filter für Nischen. `keyword_scope=people` sucht stattdessen in den eigenen Fähigkeiten der Personen, `keyword_scope=any` in beidem
`technologies`	`Shopify`	Was die Firma nutzt
`employee_range`	`11-50,51-200`	Firmengröße
`country`, `state`, `city`	`Germany` oder `DACH`	Namen oder Regionen wie Europe, DACH, Nordics
`company_domain`, `company_name`	`stripe.com`	Eine Firma
`has_phone`, `has_linkedin`	`true`	Nur Personen mit Telefonnummer oder Profil

Die Filterwerte sind englisch, also Germany statt Deutschland und Finance statt Finanzen.

Gespeicherte Listen

Eine Liste hält eine Suche fest, damit du sie später exportieren oder einer Kampagne hinzufügen kannst.

Shell

curl -X POST "https://app.argorant.com/api/v1/lists" -H "Authorization: Bearer $ARGORANT_API_KEY" \
  -H "Idempotency-Key: uk-finance-list" -H "Content-Type: application/json" \
  -d '{"name":"UK finance leaders","filters":{"title":"CFO, Finance Director","country":"United Kingdom"}}'

Schick record_ids statt filters, um genau die Personen zu behalten, die du ausgewählt hast. GET /api/v1/lists zeigt alle deine Listen, GET /api/v1/lists/{id}/people blättert durch die Personen einer Liste, POST /api/v1/lists/{id}/items fügt weitere hinzu, PATCH benennt um und DELETE entfernt eine Liste. Die list_id geht direkt in POST /api/v1/campaigns/{id}/leads.

Exporte

Ein Export baut eine CSV-Datei im Hintergrund.

Shell

curl -X POST "https://app.argorant.com/api/v1/exports" -H "Authorization: Bearer $ARGORANT_API_KEY" \
  -H "Idempotency-Key: uk-finance-export" -H "Content-Type: application/json" \
  -d '{"filters":{"title":"CFO, Finance Director","country":"United Kingdom"},"limit":500}'

Prüf status_url, bis status den Wert done hat, und lade dann von download_url herunter. Jede E-Mail wird geprüft, während die Datei entsteht, und du zahlst 1 Credit pro Person, deren E-Mail die Prüfung besteht. Personen, die du schon einmal exportiert hast, fallen weg, außer du setzt "exclude_previously_exported": false. So zahlst du nie zweimal für dieselbe Person. Ab 50.000 Zeilen wird der Export zu einem Stapel von Dateien. Den prüfst du unter GET /api/v1/export-batches/{batch_id}. POST /api/v1/lists/{id}/export exportiert eine gespeicherte Liste auf dieselbe Weise.

Telefonnummern

Füg einem Export "include_phones": true hinzu oder frag mit POST /api/v1/people/phones und den record_ids Nummern für bis zu 100 Personen an. Eine Telefonnummer kostet 10 Credits, nur wenn eine geliefert wird, und Nummern, die du schon hast, sind kostenlos. Telefonnummern gibt es ab dem Plan Pro. GET /api/v1/people/phones/pricing zeigt den Preis und ob dein Plan sie enthält.

Einen Datensatz anreichern

Wenn du schon eine E-Mail hast oder einen Namen und eine Firmen-Domain, ergänzt POST /api/v1/enrich die Person: 1 Credit für einen Treffer, dessen E-Mail die Prüfung besteht, nichts ohne Treffer, und dieselbe Person erneut ist kostenlos. Eine Firmen-Domain allein liefert das Firmenprofil kostenlos.