ArgorantDocs

Votre premier appel

Le démarrage rapide. Avec une seule clé API, vous comptez un marché, regardez les personnes, en débloquez quelques-unes, les enregistrez comme liste et préparez une campagne. Compter et regarder est gratuit.

Il vous faut une clé API. Créez-en une sur app.argorant.com/profile, sous Clés API. Elle commence par ag_live_ et ne s'affiche qu'une fois. Chaque nouveau compte reçoit un essai de 7 jours avec 100 crédits et 300 e-mails de campagne.

Shell
export ARGORANT_API_KEY=ag_live_...

Vérifier la clé

Shell
curl "https://app.argorant.com/api/v1/account" -H "Authorization: Bearer $ARGORANT_API_KEY"

Vous voyez votre forfait, vos crédits, le nombre de requêtes par minute que la clé peut envoyer et ce qui reste des limites du jour.

Compter un marché, gratuitement

Shell
curl -G "https://app.argorant.com/api/v1/people/count" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" \
  --data-urlencode "title=CFO" --data-urlencode "country=Germany" --data-urlencode "employee_range=51-200"
# {"count": 4210}

Vous ne savez pas quels mots utiliser ? GET /api/v1/lookups/industries?q=soft et GET /api/v1/lookups/titles?q=head of donnent les noms exacts, avec le nombre de personnes pour chacun.

Voir qui correspond, gratuitement

Shell
curl -G "https://app.argorant.com/api/v1/people/search" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" \
  --data-urlencode "title=CFO" --data-urlencode "country=Germany" --data-urlencode "employee_range=51-200" --data-urlencode "limit=10"

Chaque ligne montre le poste, l'entreprise et le lieu, avec le nom réduit aux initiales et sans coordonnées. Chaque ligne a un record_id.

Débloquer quelques personnes

Cette étape consomme des crédits. Dans une app ou un agent, affichez donc le prix et demandez d'abord.

Shell
curl -X POST "https://app.argorant.com/api/v1/people/reveal" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" \
  -H "Idempotency-Key: first-reveal-1" \
  -H "Content-Type: application/json" \
  -d '{"title":"CFO","country":"Germany","employee_range":"51-200","limit":5}'

Chaque e-mail est vérifié juste avant de vous être remis. Vous payez 1 crédit par personne dont l'e-mail passe la vérification, et rien pour les autres. credits_charged indique ce que cela a coûté.

Enregistrer la recherche comme liste

Shell
curl -X POST "https://app.argorant.com/api/v1/lists" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" \
  -H "Idempotency-Key: first-list-1" \
  -H "Content-Type: application/json" \
  -d '{"name":"CFOs Germany 51-200","filters":{"title":"CFO","country":"Germany","employee_range":"51-200"}}'

L'enregistrement est gratuit et ne débloque personne. Gardez le list_id.

Préparer une campagne

Shell
curl -X POST "https://app.argorant.com/api/v1/campaigns" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Idempotency-Key: first-campaign-1" \
  -H "Content-Type: application/json" -d '{"name":"CFOs Germany Q4","daily_limit":40}'

La campagne démarre comme brouillon. Rien n'est envoyé tant que vous ne la lancez pas. Trouver 200 personnes et leur écrire montre la suite : les e-mails, les personnes, les boîtes mail et le lancement.

Les mêmes étapes dans le terminal : npx argorant count, npx argorant search, npx argorant reveal, npx argorant list create, npx argorant campaigns create. Dans Claude ou ChatGPT, connectez https://mcp.argorant.com/mcp et demandez avec vos propres mots.

Sur cette page