ArgorantDocs

Vinden, opslaan en exporteren

De filters die elke zoekopdracht deelt, opgeslagen lijsten, CSV-exports, telefoonnummers en verrijking, en wat elk ervan kost.

Filters

Tellen, zoeken, onthullen, lijsten, exports en campagnes gebruiken allemaal dezelfde filters. De woordenlijsten geven de exacte namen van branches, landen, trefwoorden, technologieën en functietitels, met per naam hoeveel mensen erbij horen.

FilterVoorbeeldZo werkt het
qsoftware companies selling to restaurantsGewone woorden, gezocht in naam, functietitel, bedrijf en beschrijving
titleCFO, Finance DirectorEen komma betekent of. Kent afkortingen. exclude_title laat functietitels weg
seniorityC-Level,VPOwner, Founder, Partner, C-Level, VP, Director (past ook op Head of), Manager, Senior, Entry, Intern
departmentsFinance
industriesSoftware DevelopmentExacte namen uit de lijst met branches; een verticale streep betekent of
keywordslogistics, freightWoorden die beschrijven wat het bedrijf doet: de naam, tags, branche en beschrijving. Het breedste filter voor niches. keyword_scope=people kijkt in plaats daarvan naar de eigen vaardigheden van mensen, keyword_scope=any naar beide
technologiesShopifyWat het bedrijf gebruikt
employee_range11-50,51-200Bedrijfsgrootte
country, state, cityGermany of DACHNamen of regio's zoals Europe, DACH, Nordics
company_domain, company_namestripe.comEén bedrijf
has_phone, has_linkedintrueAlleen mensen met een telefoonnummer of een profiel
business_email_onlytrueAlleen mensen van wie het e-mailadres op het eigen domein van hun bedrijf staat. Staat uit tenzij je het instelt, dus privéadressen worden alleen op verzoek weggelaten
exclude_assistantsfalseStandaard aan. Een zoekopdracht op functietitel laat assistentfuncties weg, zoals executive assistant of assistant to. Zet het op false om ze te houden

Elk antwoord op tellen, zoeken, lijsten en exports zegt wat er naast je eigen filters is toegepast. applied_filters toont business_email_only als je het hebt aangezet, en applied_defaults toont of assistentfuncties zijn weggelaten en welke. Een opgeslagen lijst bewaart beide, naast het verzoek zoals je het stuurde (filters.request).

Regio's kunnen overlappen. Egypte hoort zowel bij Middle East als bij Africa, Mexico zowel bij North America als bij LATAM, en Turkije telt als Middle East, niet als Europe. Een persoon wordt één keer geteld, ook als meerdere regio's die je noemt zijn of haar land bevatten. EMEA is Europe, Middle East en Africa samen.

Opgeslagen lijsten

Een lijst bewaart een zoekopdracht, zodat je hem later kunt exporteren of aan een campagne kunt toevoegen.

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"}}'

Een opgeslagen zoekopdracht antwoordt meteen. snapshot_total is het aantal mensen als de telling op tijd klaar is; anders is het null, met count_status pending en een status_url. GET /api/v1/lists/{id}/fill toont de status, de aantallen, progress_percent en eta_seconds. Voeg verbose=true toe om ook de opgeslagen zoekopdracht te zien.

Stuur record_ids in plaats van filters om precies de mensen te houden die je hebt gekozen. GET /api/v1/lists toont al je lijsten, GET /api/v1/lists/{id}/people bladert door de mensen in een lijst, POST /api/v1/lists/{id}/items voegt er meer toe, PATCH hernoemt en DELETE verwijdert een lijst. De list_id gaat rechtstreeks in POST /api/v1/campaigns/{id}/leads.

Exports

Een export bouwt op de achtergrond een CSV.

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}'

Controleer status_url tot status done is en download dan via download_url. Elk e-mailadres wordt gecontroleerd terwijl het bestand wordt gebouwd, en je betaalt 1 credit per persoon van wie het e-mailadres de controle doorstaat. Mensen die je eerder hebt geëxporteerd, worden weggelaten tenzij je "exclude_previously_exported": false instelt, zodat je nooit twee keer voor dezelfde persoon betaalt. Boven 50.000 rijen wordt de export een reeks bestanden; controleer die via GET /api/v1/export-batches/{batch_id}. POST /api/v1/lists/{id}/export exporteert een opgeslagen lijst op dezelfde manier.

Telefoonnummers

Voeg "include_phones": true toe aan een export, of vraag nummers op voor tot 100 mensen met POST /api/v1/people/phones en hun record_ids. Een telefoonnummer kost 10 credits, alleen als er een wordt teruggegeven, en nummers die je al hebt zijn gratis. Telefoonnummers horen bij het Pro-plan. GET /api/v1/people/phones/pricing toont de prijs en of je plan ze bevat.

Eén record verrijken

Als je al een e-mailadres hebt, of een naam en een bedrijfsdomein, vult POST /api/v1/enrich de persoon aan: 1 credit voor een match van wie het e-mailadres de controle doorstaat, niets als er geen match is, en dezelfde persoon nog een keer is gratis. Alleen een bedrijfsdomein geeft gratis het bedrijfsprofiel terug.

Op deze pagina