Documentazione/Verifica in Blocco

Verifica in Blocco

Carica un CSV di indirizzi email e ottieni i risultati per tutta la tua lista.

Panoramica

La verifica in blocco ti permette di verificare migliaia di indirizzi email in un solo job. Carica un file CSV dalla dashboard o tramite API e scarica i risultati quando il job è completato.

ℹ️
La verifica in blocco è disponibile dalla dashboard e tramite API. Carica i file CSV con POST /api/bulk, interroga GET /api/bulk/{job_id}, poi scarica i risultati da /api/bulk/{job_id}/download.

Caricamento tramite API

Invia un caricamento CSV multipart con la tua chiave API. Puoi passare facoltativamente email_column quando il campo email non si chiama email.

bash
curl -X POST https://verimails.com/api/bulk \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@leads.csv" \
  -F "name=May outreach" \
  -F "email_column=Email Address"

Caricamento dalla dashboard

  1. Accedi a verimails.com/dashboard
  2. Clicca Verifica in Blocco nella barra laterale
  3. Carica il tuo file CSV
  4. Attendi il completamento del job (visibile nel tuo elenco dei job)
  5. Scarica il CSV dei risultati

Formato CSV

Il tuo CSV deve avere una colonna con gli indirizzi email. VeriMails rileva in automatico le intestazioni più comuni come email, Email Address, work_email, e business_email. Sono supportati anche i CSV a una sola colonna senza intestazione, ma un'intestazione email chiara resta la scelta migliore:

csv
email
john@example.com
jane@company.com
info@business.io
sales@corp.net

Le colonne aggiuntive vengono mantenute nell'output e non influiscono sull'elaborazione.

Formati supportati

Formato di output

Il file completo dei risultati mantiene le colonne originali del CSV e aggiunge una colonna chiara sulla possibilità di invio:

Colonna aggiuntaDescrizione
Safe to SendYes quando lo stato verificato è valido; No per risultati non validi, catch-all, usa e getta, sconosciuti o a rischio.

Controllo dello stato del job

Nella dashboard, l'elenco dei job mostra l'avanzamento in tempo reale. Tramite API, interroga GET /api/bulk/{job_id} finché lo stato del job non è completed oppure failed.

Notifiche webhook

Il supporto webhook per il completamento dei job in blocco arriverà presto. Vedi Webhook →

💡
Suggerimento: Per costruire liste in tempo reale, usa l' API di Verifica Singola per verificare gli indirizzi mentre li raccogli. La verifica in blocco è ideale per pulire liste esistenti.