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.
| Filter | Voorbeeld | Zo werkt het |
|---|---|---|
q | software companies selling to restaurants | Gewone woorden, gezocht in naam, functietitel, bedrijf en beschrijving |
title | CFO, Finance Director | Een komma betekent of. Kent afkortingen. exclude_title laat functietitels weg |
seniority | C-Level,VP | Owner, Founder, Partner, C-Level, VP, Director (past ook op Head of), Manager, Senior, Entry, Intern |
departments | Finance | |
industries | Software Development | Exacte namen uit de lijst met branches; een verticale streep betekent of |
keywords | logistics, freight | Woorden 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 |
technologies | Shopify | Wat het bedrijf gebruikt |
employee_range | 11-50,51-200 | Bedrijfsgrootte |
country, state, city | Germany of DACH | Namen of regio's zoals Europe, DACH, Nordics |
company_domain, company_name | stripe.com | Eén bedrijf |
has_phone, has_linkedin | true | Alleen mensen met een telefoonnummer of een profiel |
business_email_only | true | Alleen 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_assistants | false | Standaard 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.
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.
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.
Antwoorden beantwoorden
Elk antwoord uit elke campagne in één inbox. Antwoord in hetzelfde gesprek, stuur door en markeer antwoorden als geïnteresseerd, afspraak geboekt of je eigen pipelinefase.
Campagnes van begin tot eind
Maak de campagne aan, schrijf de e-mails, voeg een lijst toe, kies je mailboxen en start. Elke stap is één aanroep, en er wordt niets verstuurd vóór de start.