API · MCP · SDK

Будуйте на Cold Leads

Cold Leads — CRM для холодних розсилок, якою можна керувати з коду. Перевіряйте e-mail-адреси перед надсиланням, передавайте ліди з будь-якої форми чи системи, переміщуйте контакти воронкою і давайте своєму AI-агенту ті самі інструменти через MCP. Звичайний JSON, один заголовок авторизації та специфікація OpenAPI 3.1 для генерації клієнтів.

Отримати API-ключ Читати специфікацію OpenAPI

OpenAPI 3.1
·Авторизація x-api-key
·120 запитів на хвилину на ключ
·Хмарний MCP-сервер
·SDK з ліцензією MIT на GitHub

POST /api/v1/verify

curl -X POST https://coldleads.app/api/v1/verify \
  -H "x-api-key: $COLDLEADS_API_KEY" \
  -d '{"email":"jane@example.com"}'

{
  "email": "jane@example.com",
  "status": "valid",
  "score": 75,
  "reasons": ["smtp_unreachable"],
  "mx": "mx.example.com",
  "catch_all": null,
  "disposable": false,
  "role": false
}

Ілюстративна відповідь. Коди причин показують, чи перевірялась сама скринька.

120/хв

запитів на ключ, один заголовок авторизації

MCP-інструментів для Claude, ChatGPT і Cursor

5 днів

безкоштовного пробного періоду з API на Business

Інтерфейси

Оберіть зручний інтерфейс

REST API

Перевіряйте одну адресу чи список (пакетні завдання), шукайте контакти у власній CRM, читайте баланс кредитів. Специфікація OpenAPI 3.1 для генерації коду та для агентів, що імпортують інструменти зі специфікації.

Специфікація OpenAPI 3.1

Хуки лідів і стадій

Ключ сайту (lk_…) робить із будь-якої форми джерело лідів і може запустити автокампанію із заданою затримкою. Хук стадії позначає контакт клієнтом, коли ваша білінгова система чи CRM закриває угоду.

Хмарний MCP-сервер

https://coldleads.app/api/mcp дає Claude, ChatGPT, Cursor та іншим MCP-клієнтам 14 інструментів: імпорт і зміна контактів, перевірка адрес, написання шаблонів, підготовка кампаній і запуск після вашого схвалення, читання відповідей. OAuth або секретний ключ.

Cold Leads для AI-агентів

Node.js SDK і stdio MCP

Типізований клієнт для Node 20 і новіших та локальний MCP-сервер для Claude Desktop, Cursor і VS Code. Відкритий код, ліцензія MIT, встановлення прямо з GitHub.

github.com/anttka4cz/coldleads-node-sdk

Швидкий старт

Від реєстрації до першого виклику за кілька хвилин

Зареєструйтеся

Створіть акаунт через Google або посилання з листа. Запустіть 5-денний безкоштовний пробний період на тарифі Business, щоб спробувати API з 25 кредитами (потрібна картка, скасувати можна будь-коли до його завершення).

Створіть ключ

Налаштування → API. Секретний ключ (sk_…) для вашого сервера, ключ сайту (lk_…) для форм на сайті. Секретні ключі зберігаються хешем, показуються один раз, їх можна призупинити, замінити чи видалити.

Зробіть виклик

Надішліть ключ у заголовку x-api-key і викличте будь-який ендпоінт нижче. Помилки — JSON із коротким кодом, наприклад rate_limited, no_credits або bad_input.

Три виклики, що закривають більшість інтеграцій

# 1. Verify an address (1 credit)
curl -X POST https://coldleads.app/api/v1/verify \
  -H "x-api-key: $COLDLEADS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"jane@example.com"}'

# 2. Capture a lead from any form (website key lk_…, safe to ship in HTML)
curl -X POST "https://coldleads.app/api/hooks/lead?key=$COLDLEADS_SITE_KEY" \
  -d email=jane@example.com -d name="Jane Doe"

# 3. Move a contact along the funnel when the deal closes
curl -X POST https://coldleads.app/api/hooks/stage \
  -H "x-api-key: $COLDLEADS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"jane@example.com","stage":"customer"}'

# Node.js SDK and MCP server (installed from GitHub)
npm install --allow-git=root github:anttka4cz/coldleads-node-sdk
npx -y --allow-git=root github:anttka4cz/mcp-server-coldleads

Замініть змінні середовища своїми ключами. Адреси — ілюстративні.

Відповідь перевірки містить статус (valid, risky або invalid), бал, коди причин, MX-сервер і ознаку catch_all. Коди причин показують, чи перевірялась сама скринька.

Чому Cold Leads

Чому розробники залишаються

Звичайний JSON через HTTPS, один заголовок авторизації, помилки з короткими кодами — для старту SDK не потрібен.

Кожен ключ має власний ліміт запитів і лічильник використання, його можна призупинити чи замінити, не чіпаючи інших.

Той самий рушій веде ваші власні кампанії: на адреси, визнані недійсними, ніколи не надсилається, а кампанії йдуть із вашої скриньки Gmail, Microsoft 365 чи SMTP.

AI-агенти працюють зі схваленням: готують чернетку кампанії й запускають її лише після підтвердження людиною шаблону та аудиторії.

Агент може почати навіть без ключа: POST /api/agent/provision повертає посилання на оплату для власника-людини та claim-токен.

Ціни

$99на місяць · Business · 10,000

Ключі сайту працюють на кожному тарифі. API із секретним ключем (перевірка, пошук, пошук контактів, хук стадії) і MCP входять у Business: $99 на місяць, 10,000 кредитів на місяць. Додаткові кредити — $5 за 1 000.

Спершу спробуйте: 5-денний безкоштовний пробний період на Business містить API в межах лімітів пробного періоду (25 кредитів). Нові клієнти, що оформлять підписку протягом 24 годин після реєстрації, отримують −30% на перший платіж замість пробного періоду — разом ці пропозиції не діють.

Отримати API-ключ Тарифи

Ліміти

120 запитів на хвилину на ключ.
5 паралельних пакетних завдань, до 5 000 адрес у завданні.
1 кредит за перевірену адресу чи виклик пошуку; результати кешуються 30 днів, а повторна перевірка теж коштує кредит.
Ключі сайту (lk_…) можуть лише створювати контакти, з добовим обмеженням на ключ.

Відверто

Чим це не є

Це не база лідів: Cold Leads не продає дані про людей чи компанії й не збагачує контакти. Пошук працює по контактах вашого акаунта.

Перевірка скриньки та accept-all через SMTP виконується лише тоді, коли наш сервер може з’єднатися з поштовим сервером одержувача; інакше код причини повідомляє, що скриньку не перевіряли.

Вихідних вебхуків поки немає: читайте результати опитуванням або використовуйте MCP.

SDK і stdio MCP-сервер встановлюються з GitHub; у npm їх немає.

Рецепти

Працюйте з Cold Leads у Cursor, Claude Desktop і Windsurf через MCP

Підключіть Cold Leads MCP або Node SDK для імпорту контактів, чатів, кампаній, підтвердженого outreach і веб-заявок.

Масова перевірка e-mail в n8n з Google Sheets

Workflow для імпорту в n8n: читає Google Sheet, шле до 5 000 адрес у масове завдання Cold Leads, опитує його, розподіляє рядки за статусом і записує результати.

Перевіряйте лідів у Make.com, перш ніж вони потраплять у кампанію Instantly

Сценарій Make.com перевіряє кожного нового ліда через API Cold Leads і додає в кампанію Instantly лише валідні адреси через Instantly API v2.

Перевірка CSV на 50 000 рядків за допомогою Python, asyncio і httpx

Повний скрипт asyncio + httpx для масового API Cold Leads: завдання по 5 000, п’ять одночасно, опитування, обробка 429 і 402, CSV із продовженням після збою.

Перенесення перевірки e-mail з Hunter або Apollo в Cold Leads

Зіставте Hunter Email Verifier і Email Finder з API Cold Leads поле за полем, дізнайтеся, яким даним Apollo немає відповідника, і оцініть вартість Cold Leads.

Підписки, які ініціює агент і схвалює людина

AI-агент без ключа запитує підписку Cold Leads Business, власник-людина схвалює й оплачує її в Stripe, а агент один раз отримує API-ключ.

Усі рецепти

FAQ

FAQ для розробників

Чи потрібна картка, щоб спробувати API?

Так. 5-денний безкоштовний пробний період потребує картки, а скасувати можна до його завершення; під час нього нічого не списується. Безкоштовного тарифу немає.

Який тариф містить API?

Business ($99 на місяць, 10,000 кредитів). Ключі сайту для форм працюють на кожному тарифі. Під час пробного періоду на Business API працює в межах його лімітів.

Чи можна згенерувати клієнт зі специфікації?

Так, /api/v1/openapi.json — документ OpenAPI 3.1. Обидва хуки — звичайні HTTP-виклики, описані на цій сторінці.

Чи є SDK?

Типізований SDK для Node.js (Node 20 і новіші) та MCP-сервер для локальних клієнтів, обидва з ліцензією MIT на GitHub. Інші мови можуть користуватися HTTP API напряму.

Чи може AI-агент зареєструватися сам?

Агент викликає POST /api/agent/provision з e-mail власника. Він отримує посилання Stripe на оплату для власника-людини та claim-токен; після оплати власником агент один раз отримує свій ключ.

Що буде, коли закінчаться кредити?

Виклики повертають помилку 402 no_credits із залишком. Кредити оновлюються щомісяця, а додаткові пакети коштують $5 за 1 000.

Готові будувати?

Створіть акаунт, візьміть ключ і зробіть перший виклик за кілька хвилин.

Отримати API-ключ