API pro ověření e-mailových adres

Co jedno volání zkontroluje

Každá adresa prochází stejným postupem, který aplikace používá pro vlastní kampaně:

• Syntaxe a délka (RFC 5321).
• Dočasné a jednorázové domény podle vestavěného seznamu běžných poskytovatelů.
• Role účty (info@, sales@, support@), které na cold e-mail málokdy odpoví.
• MX záznamy: přijímá doména vůbec poštu?
• Kontrola schránky a accept-all přes SMTP, pokud se náš server spojí s poštovním serverem příjemce; jinak důvod smtp_unreachable říká, že schránka ověřena nebyla.

Tři skupiny místo skóre, které musíte vykládat

Odpověď je valid, risky nebo invalid s kódy důvodu. Na adresy ověřené jako neplatné kampaně nikdy neposílají; o rizikových (accept-all servery, jednorázové domény, nejasné nebo nedokončené kontroly) rozhodnete vy. Výsledek valid s důvodem smtp_unreachable znamená, že doména přijímá poštu, ale samotná schránka ověřena nebyla; catch_all je true, jen když kontrola accept-all proběhla.

curl -X POST https://coldleads.app/api/v1/verify \
  -H "x-api-key: sk_…" -H "Content-Type: application/json" \
  -d '{"email":"jane.doe@example.com"}'

# ilustrativní odpovědi (example.com je doména vyhrazená pro dokumentaci)
# schránka neověřena (bez SMTP spojení s poštovním serverem)
{ "status": "valid", "score": 75, "reasons": ["smtp_unreachable"], "mx": "mx.example.com", "catch_all": false }
# schránka potvrzena přes SMTP
{ "status": "valid", "score": 97, "reasons": ["ok"], "mx": "mx.example.com", "catch_all": false }

Seznamy a cena

Hromadný endpoint: až 5 000 adres v jedné úloze, 5 úloh souběžně, výsledky jako JSON (export do CSV je ve webové aplikaci). 120 požadavků za minutu na klíč. 1 kredit za adresu; tarif Business (2129 Kč/měsíc) obsahuje 10 000 kreditů a API, další balíčky stojí 109 Kč za 1 000.

Výsledky se ukládají na 30 dní, takže opakované ověření stejného seznamu je rychlé; každá kontrola ale stojí 1 kredit.

Fakturace, kterou řídíte z aplikace

Tarif změníte v Nastavení a zvolíte, kdy začne platit — dnes (nevyužité dny se započítají a začne nový zúčtovací měsíc), nebo při dalším obnovení. Kartu aktualizujete jedním kliknutím, zrušit lze kdykoli: zrušené předplatné funguje do konce zaplaceného období. Bez Stripe dashboardu, bez e-mailů na podporu.

Otázky