Authentifizierung
API-Schlüssel, die Basis-URL, was jeder Schlüssel-Scope erlaubt und wie sich KI-Agenten ohne Schlüssel anmelden.
Basis-URL
https://app.argorant.com/api/v1API-Schlüssel
Melde dich unter app.argorant.com/profile an und leg unter API-Schlüssel einen neuen an. Schlüssel beginnen mit ag_live_ und werden nur einmal angezeigt. Gib jedem Schlüssel den Namen dessen, was ihn nutzt, etwa zapier, ci oder laptop. So kannst du einen widerrufen, ohne die anderen kaputtzumachen.
Schick den Schlüssel bei jedem Aufruf mit:
curl "https://app.argorant.com/api/v1/account" \
-H "Authorization: Bearer $ARGORANT_API_KEY"Die Antwort sagt dir, für wen der Schlüssel handelt, deinen Plan, deine Credits, wie viele Anfragen pro Minute der Schlüssel senden darf und was von den heutigen Limits übrig ist. Ruf das vor einem großen Auftrag auf.
API-Schlüssel funktionieren in der 14-tägigen Testphase, in jedem Plan und mit Credits ohne Abo. Das Kommandozeilen-Tool liest denselben Schlüssel aus npx argorant login oder aus der Variable ARGORANT_API_KEY.
Scopes
Ein in der App erstellter Schlüssel hat alle Scopes unten. Ein eingeschränkter Schlüssel bekommt 403 mit dem Code scope_missing, wenn er etwas außerhalb seiner Scopes aufruft.
| Scope | Erlaubt | Kann kosten |
|---|---|---|
argorant:read_counts | Zählungen, Wortlisten, Konto, Kampagnen lesen, Posteingang, Postfächer und Webhooks | Nichts |
argorant:search_segments | Maskierte Vorschauen von Personen und Firmen | Nichts |
argorant:manage_lists | Listen, Kampagnen, Starten, Antworten beantworten, Status, Postfächer, Sperrliste, Webhooks, Postfach-Bestellungen | Postfach-Bestellungen kosten Geld, nach einem Ja |
argorant:unlock_contacts | Freischalten, Telefonnummern, Personen anreichern, E-Mail-Finder | Credits |
argorant:create_exports | Exporte und Listen-Exporte | Credits |
argorant:verify_emails | Eigene Listen prüfen | Credits, ein halber Credit pro neuer Prüfung |
KI-Agenten melden sich an, den Schlüssel sehen sie nie
MCP-Clients wie Claude und ChatGPT verbinden sich mit https://mcp.argorant.com/mcp und melden sich mit OAuth 2.1 an (Authorization Code mit PKCE). Sie handeln für dein Konto mit den Scopes, die du freigibst, und dein API-Schlüssel landet nie in einem Chat. Siehe Client verbinden.
Berechtigungen in einem Workspace
Ein Schlüssel handelt als die Person, die ihn erstellt hat. Inhaber und Mitglieder sehen nur ihren eigenen Workspace. Manche Aktionen, etwa Postfächer bestellen, sind dem Inhaber des Workspace vorbehalten. Ein Mitglied bekommt dann 403 mit einer klaren Meldung. Einträge anderer Workspaces antworten immer mit 404 not_found, genau wie Einträge, die es nicht gibt.
Einführung
Was die Argorant-API kann, was kostenlos ist, was Credits kostet und wie API, Kommandozeilen-Tool und MCP-Server zusammenspielen.
Fehler und Limits
Die eine Fehlerform, jeder Fehlercode, die Request-ID, Anfragelimits pro Plan, Limits für Suchen und Zählungen, Tageslimits, Seiten und sichere Wiederholungen.