FAQ
General
Section titled “General”What is Klozeo? Klozeo is an API-first lead database. You store, score, filter, and query business leads via REST API or natural language through MCP-compatible AI clients (Claude, Cursor, Cline, etc.).
What’s the difference between updated_at and last_interaction_at?
updated_at— changes only when a structural field (name, email, city, etc.) is modified.last_interaction_at— updates on every API push, including merges where no field changed.
Use last_interaction_at to sort by “freshness of interest” independently of data changes.
Are timestamps in milliseconds or seconds?
All timestamps are Unix seconds (not milliseconds). For JavaScript: new Date(timestamp * 1000).
Authentication
Section titled “Authentication”Where do I get an API key? Sign in at klozeo.com/dashboard → API Keys → Add new. The raw key is shown once — copy it immediately.
What if I didn’t copy my API key in time? Delete the key from the dashboard and create a new one — takes 10 seconds.
Can I have multiple API keys? Yes. Create as many keys as you need (e.g., one per integration). Revoke any key individually without affecting the others.
What happens when I push a duplicate lead? Klozeo runs 4-tier deduplication automatically. High-confidence matches (email, source_id) are merged using “Last Touch Wins”. See the Deduplication guide.
Does batch create run deduplication?
No — POST /leads/batch skips duplicate detection for performance. Use individual POST /leads calls if you need deduplication, or pre-deduplicate your dataset before importing.
What is the free plan limit? Free accounts can store up to 100 leads and make 100 API requests per 10 minutes. Upgrade to Pro for up to 500 leads and 1,000 requests/10 min. Need more than 500 leads? Contact us about an Enterprise plan with custom limits.
Can I import leads in bulk?
Yes — use POST /leads/batch (up to 100 on Free, 500 on Pro) or import CSV/JSON directly from the dashboard.
What happens if I hit the lead limit?
New leads return 403 leads_limit_reached. Existing leads and all other operations continue normally. Upgrade to Pro to increase your limit.
Which AI clients are supported? Claude Desktop, Claude Code, Cursor, Cline, Roo Code, Smithery, and Goose. Any MCP-compatible client that supports HTTP or SSE transports will work.
Do I need to share my API key with the AI client? For most clients (Claude Code, Cursor, Cline, Goose): no — a browser-based authorization flow generates and stores the key automatically. Claude Desktop currently requires a manual key in its config.
Pricing & billing
Section titled “Pricing & billing”Is a credit card required for the free plan? No. The free plan requires no payment information.