Готово до роботи через API та AI-агентів

Два типи ключів, зрозумілий радіус дії

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

Ендпоінти

Секретний ключ передавайте в заголовку x-api-key. Усі відповіді — JSON; помилки мають короткий код, як-от rate_limited або bad_input.

POST /api/v1/verify            { "email": "jane@example.com" }
POST /api/v1/verify/bulk       { "emails": ["…"], "name": "expo-2026" }   → job id
GET  /api/v1/verify/jobs/{id}  → progress and valid / risky / invalid counts; ?results=1 adds per-address results
POST /api/v1/find              { "name": "Jane Doe", "domain": "example.com" }
GET  /api/v1/credits           → credits left this month
POST /api/hooks/lead           email, name, company, phone, message, tag   (lk_ website key)
POST /api/hooks/stage          { "email": "jane@example.com", "stage": "customer" }
GET  /api/v1/leads?domain=example.com   → contacts already in your own CRM (0 credits)
POST /api/mcp                  MCP for AI agents: search_leads, verify_email

Ліміти: 120 запитів за хвилину на ключ · 5 паралельних задач · 5 000 адрес у задачі · 1 кредит за перевірену адресу або пошук адреси

Підключіть до AI-агента

Специфікація на /api/v1/openapi.json (OpenAPI 3.1) описує ендпоінти /api/v1 зі схемами (обидва хуки вище — звичайні HTTP-виклики), тож агент викликає їх без власного коду:

• ChatGPT: створіть GPT, імпортуйте специфікацію як Action і налаштуйте автентифікацію API-ключем у заголовку x-api-key.
• Claude та будь-яка модель з function calling: згенеруйте визначення інструментів зі специфікації, додайте хук для лідів і дозвольте моделі перевіряти, шукати й передавати в одній розмові.
• Copilot Studio, n8n, Make, Zapier: достатньо HTTP-вузла з тим самим заголовком; завдяки id масової задачі довгі списки — двокроковий процес.
• Типовий запуск агента: узяти список із таблиці, перевірити, відкинути невалідні адреси, передати валідні в CRM з тегом і перевести контакт в етап «клієнт», коли угоду закрито.

Node.js SDK і MCP-сервер

На GitHub є два клієнти цього API з відкритим кодом під ліцензією MIT, і встановлюються вони прямо звідти. Node.js SDK — типізований клієнт для Node 20 і новіших. MCP-сервер дає Claude Desktop, Cursor, VS Code та іншим MCP-клієнтам, які вміють запускати локальний сервер, користуватися Cold Leads як інструментом.

Агентам із підтримкою MCP через HTTP нічого не треба встановлювати: вони підключаються до https://coldleads.app/api/mcp із секретним ключем у заголовку Authorization: Bearer.

• code Node.js SDK — github.com/anttka4cz/coldleads-node-sdk
• code MCP-сервер — github.com/anttka4cz/mcp-server-coldleads

Автоматизація після виклику

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

Тарифи та ліміти

Веб-ключі працюють у кожному тарифі. Секретні ключі — API перевірки й пошуку та хук етапів — входять у Business ($99 на місяць) разом із 10 000 кредитами на місяць; додаткові пакети коштують $5 за 1 000. Результати 30 днів зберігаються в кеші (кожна перевірка все одно коштує 1 кредит), а всі перевірки виконуються із серверів Cold Leads, ніколи з вашого домену.

Питання