REST: GET /api/mcp/people/count

Herausgegeben von Argorant

Kostenlose Marktzählungen. Der Endpunkt, den du zehnmal aufrufen solltest, bevor du einmal ausgibst.

Zählungen kosten keine Kontakt-Credits, brauchen aber eine Berechtigung und bleiben durch Rate-Limits begrenzt. Dieser Endpunkt zählt passende Kontaktdatensätze, keine einzelnen Firmen und keine bereits verifizierten zustellbaren Adressen.

curl -G -H "Authorization: Bearer ag_live_..." \
  --data-urlencode "keywords=logistics" \
  --data-urlencode "country=Germany" \
  --data-urlencode "seniority=vp" \
  https://app.argorant.com/api/mcp/people/count

Parameter

Filter werden als Query-Parameter übergeben. Die Menge entspricht dem, was die CLI anbietet:

  • Freitext: q
  • Rolle: title, exclude_title, seniority, departments
  • Firmendaten: industry, keywords, company_name, company_domain
  • Region: country (Regionen wie Europe, EMEA, DACH, Nordics, APAC, LATAM und GCC werden in ihre Mitgliedsländer aufgelöst), state, city
  • Vorhandene Daten: has_email, has_phone, has_linkedin, verified_only

keywords ist der breiteste und verlässlichste Filter, ein Komma bedeutet ODER. Nimm ihn statt industry, wenn eine Zählung kleiner ausfällt als erwartet.

JSON-Antwort des Zähl-Endpunkts mit einer Zahl aus dem Bestand
JSON-Antwort des Zähl-Endpunkts mit einer Zahl aus dem Bestand

Die Antwort enthält die Zahl. Der entsprechende CLI-Aufruf ist npx argorant count --keywords logistics --country Germany --json.

Ein Hinweis, den du kennen solltest: exclude_title greift bei Export und Listenerstellung, aber noch nicht bei der Zählung. Die CLI gibt dazu einen Hinweis aus, statt den Filter still wegzulassen.

Kommst du nicht weiter? support@argorant.com