ArgorantDocs

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.

FiltroEsempioCome funziona
qsoftware companies selling to restaurantsParole normali, cercate in nome, qualifica, azienda e descrizione
titleCFO, Finance DirectorUna virgola significa oppure. Riconosce le abbreviazioni. exclude_title esclude delle qualifiche
seniorityC-Level,VPOwner, Founder, Partner, C-Level, VP, Director (corrisponde anche a Head of), Manager, Senior, Entry, Intern
departmentsFinance
industriesSoftware DevelopmentNomi esatti dalla lista dei settori; una barra verticale significa oppure
keywordslogistics, freightParole 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
technologiesShopifyCosa usa l'azienda
employee_range11-50,51-200Dimensione dell'azienda
country, state, cityGermany o DACHNomi o regioni come Europe, DACH, Nordics
company_domain, company_namestripe.comUna sola azienda
has_phone, has_linkedintrueSolo persone con un numero di telefono o un profilo
business_email_onlytrueSolo persone la cui email è sul dominio della loro azienda. Disattivato se non lo imposti, quindi gli indirizzi privati vengono esclusi solo su richiesta
exclude_assistantsfalseAttivo 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.

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

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.

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

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.

In questa pagina