Trouver, enregistrer et exporter
Les filtres communs à toutes les recherches, les listes enregistrées, les exports CSV, les numéros de téléphone et l'enrichissement, et ce que coûte chacun.
Filtres
Le comptage, la recherche, le déblocage, les listes, les exports et les campagnes utilisent tous les mêmes filtres. Les listes de mots donnent les noms exacts des secteurs, pays, mots-clés, technologies et intitulés de poste, avec le nombre de personnes pour chacun.
| Filtre | Exemple | Fonctionnement |
|---|---|---|
q | software companies selling to restaurants | Des mots simples, cherchés dans le nom, l'intitulé de poste, l'entreprise et la description |
title | CFO, Finance Director | Une virgule signifie « ou ». Reconnaît les abréviations. exclude_title exclut des intitulés |
seniority | C-Level,VP | Owner, Founder, Partner, C-Level, VP, Director (correspond aussi à Head of), Manager, Senior, Entry, Intern |
departments | Finance | |
industries | Software Development | Les noms exacts de la liste des secteurs ; une barre verticale signifie « ou » |
keywords | logistics, freight | Des mots qui décrivent ce que fait l'entreprise : son nom, ses tags, son secteur et sa description. Le filtre le plus large pour les niches. keyword_scope=people porte plutôt sur les compétences des personnes elles-mêmes, keyword_scope=any sur les deux |
technologies | Shopify | Ce que l'entreprise utilise |
employee_range | 11-50,51-200 | Taille de l'entreprise |
country, state, city | Germany ou DACH | Des noms ou des régions comme Europe, DACH, Nordics |
company_domain, company_name | stripe.com | Une seule entreprise |
has_phone, has_linkedin | true | Seulement les personnes avec un numéro de téléphone ou un profil |
business_email_only | true | Seulement les personnes dont l'e-mail est sur le domaine propre de leur entreprise. Désactivé tant que vous ne l'activez pas : les adresses privées ne sont donc exclues que sur demande |
exclude_assistants | false | Activé par défaut. Une recherche par intitulé exclut les postes d'assistant, comme executive assistant ou assistant to. Mettez-le à false pour les garder |
Chaque réponse de comptage, de recherche, de liste et d'export indique ce qui a été appliqué en plus de vos propres filtres. applied_filters affiche business_email_only quand vous l'avez activé, et applied_defaults indique si des postes d'assistant ont été exclus, et lesquels. Une liste enregistrée conserve les deux, à côté de la requête telle que vous l'avez envoyée (filters.request).
Les régions peuvent se chevaucher. L'Égypte fait partie à la fois de Middle East et d'Africa, le Mexique à la fois de North America et de LATAM, et la Turquie compte dans Middle East, pas dans Europe. Une personne n'est comptée qu'une fois, même quand plusieurs des régions indiquées contiennent son pays. EMEA regroupe l'Europe, le Moyen-Orient et l'Afrique.
Listes enregistrées
Une liste conserve une recherche pour que vous puissiez l'exporter ou l'ajouter à une campagne plus tard.
curl -X POST "https://app.argorant.com/api/v1/lists" -H "Authorization: Bearer $ARGORANT_API_KEY" \
-H "Idempotency-Key: uk-finance-list" -H "Content-Type: application/json" \
-d '{"name":"UK finance leaders","filters":{"title":"CFO, Finance Director","country":"United Kingdom"}}'Une recherche enregistrée répond immédiatement. snapshot_total donne le nombre de personnes quand le comptage se termine à temps ; sinon il vaut null, avec count_status à pending et une status_url. GET /api/v1/lists/{id}/fill affiche le statut, les compteurs, progress_percent et eta_seconds. Ajoutez verbose=true pour voir aussi la recherche enregistrée.
Envoyez record_ids au lieu de filters pour garder exactement les personnes que vous avez choisies. GET /api/v1/lists affiche toutes vos listes, GET /api/v1/lists/{id}/people parcourt page par page les personnes d'une liste, POST /api/v1/lists/{id}/items en ajoute d'autres, PATCH renomme une liste et DELETE la supprime. Le list_id se passe directement à POST /api/v1/campaigns/{id}/leads.
Exports
Un export génère un fichier CSV en arrière-plan.
curl -X POST "https://app.argorant.com/api/v1/exports" -H "Authorization: Bearer $ARGORANT_API_KEY" \
-H "Idempotency-Key: uk-finance-export" -H "Content-Type: application/json" \
-d '{"filters":{"title":"CFO, Finance Director","country":"United Kingdom"},"limit":500}'Consultez status_url jusqu'à ce que status vaille done, puis téléchargez depuis download_url. Chaque e-mail est vérifié pendant la génération du fichier, et vous payez 1 crédit par personne dont l'e-mail passe la vérification. Les personnes déjà exportées sont exclues, sauf si vous mettez "exclude_previously_exported": false : vous ne payez donc jamais deux fois pour la même personne. Au-delà de 50 000 lignes, l'export devient un lot de fichiers ; suivez-le avec GET /api/v1/export-batches/{batch_id}. POST /api/v1/lists/{id}/export exporte une liste enregistrée de la même façon.
Numéros de téléphone
Ajoutez "include_phones": true à un export, ou demandez les numéros de 100 personnes au plus avec POST /api/v1/people/phones et leurs record_ids. Un numéro de téléphone coûte 10 crédits, uniquement quand un numéro est renvoyé, et les numéros que vous avez déjà sont gratuits. Les numéros de téléphone sont inclus à partir du forfait Pro. GET /api/v1/people/phones/pricing affiche le prix et indique si votre forfait les inclut.
Enrichir une fiche
Quand vous avez déjà un e-mail, ou un nom et un domaine d'entreprise, POST /api/v1/enrich complète la fiche de la personne : 1 crédit pour une correspondance dont l'e-mail passe la vérification, rien en l'absence de correspondance, et la même personne une seconde fois est gratuite. Un domaine d'entreprise seul renvoie gratuitement le profil de l'entreprise.
Répondre aux réponses
Toutes les réponses de toutes les campagnes dans une seule boîte de réception. Répondez dans le même fil, transférez, et marquez les réponses comme intéressé, rendez-vous pris ou votre propre étape de pipeline.
Les campagnes de bout en bout
Créez la campagne, rédigez les e-mails, ajoutez une liste, choisissez vos boîtes mail et lancez. Chaque étape est un seul appel, et rien n'est envoyé avant le lancement.