Trova, salva ed esporta
I filtri comuni a ogni ricerca, le liste salvate, le esportazioni CSV, i numeri di telefono e l'arricchimento, e quanto costa ciascuno.
Filtri
Conteggi, ricerche, email mostrate, liste, esportazioni e campagne usano tutti gli stessi filtri. Le liste di valori (in inglese) danno i nomi esatti di settori, paesi, parole chiave, tecnologie e qualifiche, con quante persone corrispondono a ciascuno.
| Filtro | Esempio | Come funziona |
|---|---|---|
q | software companies selling to restaurants | Parole normali, cercate in nome, qualifica, azienda e descrizione |
title | CFO, Finance Director | Una virgola significa oppure. Riconosce le abbreviazioni. exclude_title esclude delle qualifiche |
seniority | C-Level,VP | Owner, Founder, Partner, C-Level, VP, Director (corrisponde anche a Head of), Manager, Senior, Entry, Intern |
departments | Finance | |
industries | Software Development | Nomi esatti dalla lista dei settori; una barra verticale significa oppure |
keywords | logistics, freight | Parole che descrivono cosa fa l'azienda: il suo nome, i tag, il settore e la descrizione. Il filtro più ampio per le nicchie. keyword_scope=people guarda invece le competenze delle persone stesse, keyword_scope=any entrambe |
technologies | Shopify | Cosa usa l'azienda |
employee_range | 11-50,51-200 | Dimensione dell'azienda |
country, state, city | Germany o DACH | Nomi o regioni come Europe, DACH, Nordics |
company_domain, company_name | stripe.com | Una sola azienda |
has_phone, has_linkedin | true | Solo persone con un numero di telefono o un profilo |
business_email_only | true | Solo persone la cui email è sul dominio della loro azienda. Disattivato se non lo imposti, quindi gli indirizzi privati vengono esclusi solo su richiesta |
exclude_assistants | false | Attivo per impostazione predefinita. Una ricerca per qualifica esclude le qualifiche da assistente, come executive assistant o assistant to. Impostalo su false per tenerle |
Ogni risposta di conteggio, ricerca, lista ed esportazione indica cosa è stato applicato oltre ai tuoi filtri. applied_filters mostra business_email_only quando l'hai attivato, e applied_defaults mostra se le qualifiche da assistente sono state escluse e quali. Una lista salvata conserva entrambi, accanto alla richiesta così come l'hai inviata (filters.request).
Le regioni possono sovrapporsi. L'Egitto è sia in Middle East sia in Africa, il Messico è sia in North America sia in LATAM, e la Turchia conta come Middle East, non come Europe. Una persona viene contata una sola volta, anche quando più regioni che indichi includono il suo paese. EMEA è Europa, Medio Oriente e Africa insieme.
Liste salvate
Una lista conserva una ricerca, così puoi esportarla o aggiungerla a una campagna più tardi.
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"}}'Una ricerca salvata risponde subito. snapshot_total è il numero di persone quando il conteggio finisce in tempo; altrimenti è null, con count_status pending e uno status_url. GET /api/v1/lists/{id}/fill mostra lo stato, i conteggi, progress_percent e eta_seconds. Aggiungi verbose=true per vedere anche la ricerca salvata.
Invia record_ids invece di filters per tenere esattamente le persone che hai scelto. GET /api/v1/lists mostra tutte le tue liste, GET /api/v1/lists/{id}/people scorre le persone di una lista, POST /api/v1/lists/{id}/items ne aggiunge altre, PATCH rinomina e DELETE elimina una lista. Il list_id va direttamente in POST /api/v1/campaigns/{id}/leads.
Esportazioni
Un'esportazione crea un CSV in background.
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}'Controlla status_url finché status è done, poi scarica da download_url. Ogni email viene controllata mentre il file viene creato, e paghi 1 credito per ogni persona la cui email supera il controllo. Le persone che hai già esportato vengono escluse, a meno che tu non imposti "exclude_previously_exported": false, così non paghi mai due volte la stessa persona. Oltre 50.000 righe l'esportazione diventa un gruppo di file; controllalo su GET /api/v1/export-batches/{batch_id}. POST /api/v1/lists/{id}/export esporta una lista salvata allo stesso modo.
Numeri di telefono
Aggiungi "include_phones": true a un'esportazione, oppure chiedi i numeri di un massimo di 100 persone con POST /api/v1/people/phones e i loro record_ids. Un numero di telefono costa 10 crediti, solo quando ne viene restituito uno, e i numeri che hai già sono gratis. I numeri di telefono sono inclusi dal piano Pro. GET /api/v1/people/phones/pricing mostra il prezzo e se il tuo piano li include.
Arricchisci un record
Quando hai già un'email, oppure un nome e un dominio aziendale, POST /api/v1/enrich completa i dati della persona: 1 credito per una corrispondenza la cui email supera il controllo, niente se non trova nulla, e la stessa persona una seconda volta è gratis. Un dominio aziendale da solo restituisce gratis il profilo dell'azienda.
Rispondi alle risposte
Ogni risposta di ogni campagna in un'unica posta in arrivo. Rispondi nella stessa conversazione, inoltra e segna le risposte come interessato, appuntamento fissato o una fase della tua pipeline.
Campagne dall'inizio alla fine
Crea la campagna, scrivi le email, aggiungi una lista, scegli le caselle e avvia. Ogni passaggio è una chiamata, e nulla parte prima dell'avvio.