Připraveno pro API a AI agenty

Dva druhy klíčů, jasný dosah

Klíče žijí v Nastavení → API klíče a vytvoříte je na jeden klik. Webové klíče (lk_…) jsou veřejné: umí jen zakládat kontakty a jsou bezpečné i ve formuláři na vašem webu. Tajné klíče (sk_…) odemykají ověřovací API a hook pro fáze, ukládají se hashované a kdykoli je lze pozastavit, přegenerovat nebo smazat. U každého klíče vidíte, kdy byl naposledy použit.

Endpointy

Tajný klíč posílejte v hlavičce x-api-key. Všechny odpovědi jsou JSON; chyby nesou krátký kód jako rate_limited nebo 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

Limity: 120 požadavků za minutu na klíč · 5 souběžných úloh · 5 000 adres v úloze · 1 kredit za ověřenou adresu nebo dohledání adresy

Zapojte to do AI agenta

Specifikace na /api/v1/openapi.json (OpenAPI 3.1) popisuje endpointy /api/v1 včetně schémat (oba hooky výše jsou obyčejná HTTP volání), takže je agent zavolá bez vlastního kódu:

• ChatGPT: vytvořte GPT, naimportujte specifikaci jako Action a nastavte ověření API klíčem v hlavičce x-api-key.
• Claude a jakýkoli model s voláním funkcí: vygenerujte definice nástrojů ze specifikace, přidejte hook pro leady a nechte model ověřovat, hledat a posílat v jedné konverzaci.
• Copilot Studio, n8n, Make, Zapier: stačí HTTP uzel se stejnou hlavičkou; díky id hromadné úlohy jsou dlouhé seznamy dvoukrokový proces.
• Typický běh agenta: vezme seznam z tabulky, ověří ho, vyřadí neplatné adresy, platné pošle do CRM se štítkem a při uzavření obchodu posune kontakt do fáze „zákazník“.

Node.js SDK a MCP server

Na GitHubu jsou dva open-source klienti tohoto API pod licencí MIT a instalují se přímo odtud. Node.js SDK je typovaný klient pro Node 20 a novější. MCP server umožní Claude Desktop, Cursoru, VS Code a dalším MCP klientům, které umí spustit lokální server, používat Cold Leads jako nástroj.

Agenti s podporou MCP přes HTTP nemusí nic instalovat: připojí se k https://coldleads.app/api/mcp s tajným klíčem v hlavičce Authorization: Bearer.

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

Automatizace po volání

Kontakty poslané přes klíč mohou po nastavené prodlevě spustit automatickou kampaň: uvítací nebo navazující e-mail odejde z vaší vlastní schránky se zkušebním během, denními limity a lidským tempem. Hook pro fáze umožní vašemu fakturačnímu či CRM systému označit kontakt jako zákazníka ve chvíli uzavření obchodu, takže trychtýř zůstává pravdivý, aniž by kdokoli upravoval záznamy.

Tarify a limity

Webové klíče fungují v každém tarifu. Tajné klíče — ověřovací a vyhledávací API a hook pro fáze — jsou součástí tarifu Business (2129 Kč měsíčně) spolu s 10 000 kredity měsíčně; další balíčky stojí 109 Kč za 1 000. Výsledky zůstávají 30 dní v cache (každá kontrola přesto stojí 1 kredit) a všechny kontroly běží ze serverů Cold Leads, nikdy z vaší domény.

Otázky