Verifica una lista

Una lista di verifica controlla molti indirizzi in una sola volta, ad esempio prima di importare contatti da un altro sistema o di inviare una campagna a una lista datata. Questa guida mostra come creare una lista, seguirne l’avanzamento, leggerne gli esiti ed esportarli.

Prima di iniziare

• Una lista può contenere fino a 10.000 indirizzi. Dividi i file più grandi in più liste.
• Ogni indirizzo unico costa 5 crediti, addebitati quando crei la lista. Una lista di 10.000 indirizzi richiede 50.000 crediti.
• Le liste usano sempre la modalità full, che include il controllo della casella. Vedi Modalità rapida e completa.
• Per l’API, usa una chiave API con Full Access.

Crea una lista

curl https://api.emailit.com/v2/email-verification-lists \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Newsletter import October",
    "emails": ["ada@example.com", "grace@example.com", "alan@example.com"]
  }'

{
  "object": "email_verification_list",
  "id": "evl_3Rt8Wq5Lm2Kx",
  "name": "Newsletter import October",
  "status": "processing",
  "stats": {
    "total_emails": 3,
    "processed_emails": 0,
    "successful_verifications": 0,
    "failed_verifications": 0,
    "pending_emails": 3
  },
  "created_at": "2026-10-01T11:02:37Z",
  "updated_at": "2026-10-01T11:02:37Z",
  "valid_emails_count": 3,
  "unique_emails_count": 3,
  "invalid_emails_count": 0,
  "dispatched_jobs": 3
}

Prima di addebitare, Emailit ripulisce l’input: converte ogni indirizzo in minuscolo, rimuove i duplicati e scarta le voci senza @. Ti vengono addebitati solo gli indirizzi unici rimasti. Se la lista non può essere avviata, i crediti vengono rimborsati.

Segui l’avanzamento

Lo stato della lista attraversa queste fasi:

In Email Verification›Lists, la colonna Statistics mostra i conteggi Total, Pending, Successful e Failed di ogni lista. La colonna Expiring mostra quanti giorni mancano all’eliminazione della lista.

Con l’API, chiama Recupera una lista e leggi status e stats. Per evitare il polling, iscrivi un webhook a email_verification_list.updated, che viene generato quando la lista è completata. Ogni indirizzo genera anche email_verification.updated quando il suo esito è pronto.

Controlla gli esiti

Seleziona una lista nel pannello per aprirla. La pagina mostra:

• i riquadri Created, Status, Total Emails, Pending, Successful e Failed,
• i grafici Verification Status Progress, Verification Results Breakdown e Risk Levels,
• una tabella con ogni indirizzo, con stato, esito, rischio e punteggio.

Con l’API, chiama Elenca gli esiti. Filtra per result o status e scorri le pagine con page e limit (predefinito 50):

curl -G https://api.emailit.com/v2/email-verification-lists/evl_3Rt8Wq5Lm2Kx/results \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  --data-urlencode "result=invalid" \
  --data-urlencode "limit=100"

Ogni elemento contiene id, email, status, result, score, risk e mx_records dell’indirizzo. Esiti della verifica spiega ogni valore e cosa farne.

Esporta gli esiti

Quando una lista è completed, puoi scaricarne tutti gli esiti come file Excel.

curl https://api.emailit.com/v2/email-verification-lists/evl_3Rt8Wq5Lm2Kx/export \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -o results.xlsx

Il file ha una riga per indirizzo con stato, esito, punteggio e rischio, ogni singolo controllo (sintassi valida, usa e getta, indirizzo di ruolo, casella piena, consegnabile, disattivato, email gratuita, casuale, catch-all, connessione SMTP, record MX), le parti dell’indirizzo, l’età del dominio, il suggerimento did_you_mean e i record MX. Gli esiti sono evidenziati con colori diversi per poterli scorrere rapidamente.

Usa gli esiti

1. Rimuovi gli indirizzi con esito invalid, disabled o disposable prima di importare o inviare.
2. Controlla gli indirizzi inbox_full, role e unknown. Tienili se hai un motivo per farlo, ma tieni d’occhio i loro bounce.
3. Importa il resto nei contatti o in una lista.

Per ogni esito, vedi Azioni consigliate.

Vedi anche