ArgorantDocs

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.

FiltreExempleFonctionnement
qsoftware companies selling to restaurantsDes mots simples, cherchés dans le nom, l'intitulé de poste, l'entreprise et la description
titleCFO, Finance DirectorUne virgule signifie « ou ». Reconnaît les abréviations. exclude_title exclut des intitulés
seniorityC-Level,VPOwner, Founder, Partner, C-Level, VP, Director (correspond aussi à Head of), Manager, Senior, Entry, Intern
departmentsFinance
industriesSoftware DevelopmentLes noms exacts de la liste des secteurs ; une barre verticale signifie « ou »
keywordslogistics, freightDes 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
technologiesShopifyCe que l'entreprise utilise
employee_range11-50,51-200Taille de l'entreprise
country, state, cityGermany ou DACHDes noms ou des régions comme Europe, DACH, Nordics
company_domain, company_namestripe.comUne seule entreprise
has_phone, has_linkedintrueSeulement les personnes avec un numéro de téléphone ou un profil
business_email_onlytrueSeulement 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_assistantsfalseActivé 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.

Shell
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.

Shell
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.

Sur cette page