Ověření seznamu

Seznam k ověření zkontroluje mnoho adres najednou, například před importem kontaktů z jiného systému nebo před odesláním kampaně na starý seznam. Tento návod ukazuje, jak seznam vytvořit, sledovat jeho průběh, číst výsledky a vyexportovat je.

Než začnete

• Seznam může obsahovat až 10 000 adres. Větší soubory rozdělte do více seznamů.
• Každá unikátní adresa stojí 5 kreditů, které se účtují při vytvoření seznamu. Seznam s 10 000 adresami potřebuje 50 000 kreditů.
• Seznamy vždy používají režim full, který zahrnuje kontrolu schránky. Viz Rychlý a úplný režim.
• Pro API použijte API klíč s oprávněním Full Access.

Vytvořte seznam

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
}

Před naúčtováním Emailit vstup vyčistí: všechny adresy převede na malá písmena, odstraní duplicity a vyřadí položky bez @. Účtují se vám jen unikátní adresy, které zbudou. Pokud se seznam nepodaří spustit, kredity se vrátí.

Sledujte průběh

Stav seznamu prochází těmito fázemi:

V Email Verification›Lists ukazuje sloupec Statistics u každého seznamu počty Total, Pending, Successful a Failed. Sloupec Expiring ukazuje, kolik dní zbývá do smazání seznamu.

Přes API zavolejte endpoint Načtení seznamu k ověření a čtěte status a stats. Pokud se nechcete opakovaně dotazovat, přihlaste webhook k odběru události email_verification_list.updated, která nastane po dokončení seznamu. Každá adresa navíc vyvolá email_verification.updated, jakmile je její výsledek hotový.

Projděte výsledky

Výběrem seznamu ve webovém rozhraní ho otevřete. Stránka ukazuje:

• panely Created, Status, Total Emails, Pending, Successful a Failed,
• grafy Verification Status Progress, Verification Results Breakdown a Risk Levels,
• tabulku všech adres s jejich stavem, výsledkem, rizikem a skóre.

Přes API zavolejte endpoint Výpis výsledků. Filtrujte podle result nebo status a stránkujte parametry page a limit (výchozí hodnota 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"

Každá položka obsahuje id, email, status, result, score, risk a mx_records adresy. Všechny hodnoty a co s nimi dělat vysvětluje stránka Výsledky ověření.

Vyexportujte výsledky

Jakmile je seznam ve stavu completed, můžete si všechny jeho výsledky stáhnout jako soubor Excel.

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

Soubor má pro každou adresu jeden řádek s jejím stavem, výsledkem, skóre a rizikem, všemi jednotlivými kontrolami (platná syntaxe, jednorázová adresa, rolová adresa, plná schránka, doručitelnost, deaktivace, bezplatný e-mail, nesmyslná adresa, catch-all, připojení přes SMTP, MX záznamy), částmi adresy, stářím domény, návrhem did_you_mean a MX záznamy. Výsledky jsou barevně odlišené, takže je rychle přehlédnete.

Využijte výsledky

1. Odstraňte adresy s výsledkem invalid, disabled nebo disposable před importem nebo odesláním.
2. Zkontrolujte adresy inbox_full, role a unknown. Pokud k tomu máte důvod, ponechte si je, ale sledujte jejich nedoručení.
3. Naimportujte zbytek do svých kontaktů nebo seznamu kontaktů.

Doporučený postup pro jednotlivé výsledky najdete v části Doporučené akce.

Související