REST: Endpunkte für Firmen

Die Firmen-Endpunkte beantworten Fragen auf Account-Ebene statt auf Personenebene. Alle sind kostenlos.

Zählungen und Suche

GET /api/mcp/companies/count
GET /api/mcp/companies/search

Sie nehmen dieselben Firmenfilter wie die Personensuche: Keywords, Branche, Land, Bundesland, Stadt und Firmengröße. Nutze sie, wenn die Frage lautet, wie viele Firmen passen, nicht wie viele Personen.

Personen bei einer Firma

GET /api/mcp/companies/{domain}/people

Übergib eine reine Domain wie stripe.com. Optionale Query-Parameter grenzen das Ergebnis ein: title, seniority, departments, country und limit.

Was zurückkommt

Der Firmendatensatz, einschließlich der angegebenen Mitarbeiterschätzung, soweit vorhanden.
Wie viele Personen dieser Firma im Datenbestand sind.
Wie viele davon eine geschäftliche E-Mail-Adresse haben. Diese Zahl sagt voraus, wie viele du tatsächlich erreichen könntest.
Eine maskierte Vorschau der Rollen bis zu deinem Limit, damit du siehst, welche Funktionen es gibt, bevor du etwas ausgibst.

Ausgabe der Firmenabfrage mit Personenzahl und Abdeckung geschäftlicher E-Mails

Die CLI verpackt das in einen Befehl:

npx argorant company stripe.com -n 5
npx argorant company stripe.com --title CFO --json

So qualifiziert ein Agent am schnellsten eine Liste von Ziel-Accounts: Gib ihm Domains, bekomm Abdeckungszahlen zurück, und streich die Accounts, die du nicht erreichen kannst, bevor du eine Kampagne darum baust.