API перевірки e-mail-адрес

Що перевіряє один виклик

Кожна адреса проходить той самий конвеєр, що й розсилки в самому застосунку:

• Синтаксис і довжина (RFC 5321).
• Одноразові й тимчасові домени за вбудованим списком поширених сервісів.
• Рольові акаунти (info@, sales@, support@), які рідко відповідають на холодні листи.
• MX-записи: чи домен узагалі приймає пошту?
• Перевірка скриньки та accept-all через SMTP, коли наш сервер може з’єднатися з поштовим сервером одержувача; інакше причина smtp_unreachable показує, що скриньку не перевірено.

Три групи замість балів, які треба тлумачити

Відповідь — valid, risky або invalid із кодами причини. На адреси, визнані недійсними, кампанії ніколи не надсилають; ризиковані (accept-all сервери, одноразові домени, непевні або незавершені перевірки) вирішуєте ви. Результат valid з причиною smtp_unreachable означає, що домен приймає пошту, але саму скриньку не перевірено; catch_all дорівнює true, лише коли перевірка accept-all відбулася.

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

# ілюстративні відповіді (example.com зарезервовано для документації)
# скриньку не перевірено (немає SMTP-з’єднання з поштовим сервером)
{ "status": "valid", "score": 75, "reasons": ["smtp_unreachable"], "mx": "mx.example.com", "catch_all": false }
# скриньку підтверджено через SMTP
{ "status": "valid", "score": 97, "reasons": ["ok"], "mx": "mx.example.com", "catch_all": false }

Списки та ціна

Масовий endpoint: до 5 000 адрес у завданні, 5 завдань паралельно, результати як JSON (експорт у CSV — у веб-застосунку). 120 запитів на хвилину на ключ. 1 кредит за адресу; тариф Business ($99/місяць) містить 10 000 кредитів і API, додаткові пакети — $5 за 1 000.

Результати кешуються 30 днів, тож повторна перевірка того самого списку швидка; але кожна перевірка коштує 1 кредит.

Оплата, якою ви керуєте з застосунку

Тариф змінюється в Налаштуваннях, і ви обираєте, коли він почне діяти — сьогодні (невикористані дні зараховуються, починається новий розрахунковий місяць) або з наступного поновлення. Картку оновлюєте одним кліком, скасувати можна будь-коли: скасована підписка працює до кінця оплаченого періоду. Без панелі Stripe і листів у підтримку.

Питання