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.
export ARGORANT_API_KEY=ag_live_...Vérifier la clé
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
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
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.
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
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
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.
Guides
Des guides pas à pas pour ce que l'on fait le plus souvent avec Argorant : le premier appel, trouver des personnes et leur écrire, les réponses, les crédits, les boîtes mail et les webhooks.
Trouver 200 personnes et leur écrire
De votre cible à une campagne en cours : réduisez à environ 200 personnes, rédigez les e-mails avec une phrase personnalisée, choisissez les boîtes mail et lancez après un oui.