AI Features - SMB Sales Boost API
Access AI-powered tools including keyword suggestions, category recommendations, auto-refine optimization, and website analysis. Leverage machine learning to optimize your prospecting strategy.
Rate limit: AI endpoints are limited to 5 requests per minute.
Endpoints
POST /api/v1/ai/suggest-categories- Get AI-powered category suggestions based on your business type and target market. Requires companyName, companyDescription, and productService.
POST /api/v1/ai/generate-keywords- Trigger AI keyword generation based on your account's target categories (up to 3 per list) and business profile. This is an asynchronous operation — keywords are generated as wildcard patterns and saved to your keyword lists with auto-refine enabled by default.
GET /api/v1/ai/keyword-status- Check the status of keyword generation jobs, including refinement progress.
GET /api/v1/ai/auto-refine/status- Get auto-refine status for all keyword lists or a specific list. Returns refinement progress, quality scores, and timing.
POST /api/v1/ai/auto-refine/enable- Enable AI auto-refine for a keyword list and start the optimization process. Requires listId.
POST /api/v1/ai/auto-refine/disable- Disable AI auto-refine for a keyword list. Pauses any in-progress refinement.
Category Suggestion Parameters
Required: companyName, companyDescription, productService. Optional: companyWebsite, smbType, excludeCategories.
AI Auto Refine
The auto-refine system uses a single-pass, 4-phase process to optimize keyword lists. Phase 1 validates each positive keyword individually (50% applicability threshold). Phase 1B discovers up to 15 new positive keywords (5-added target). Phase 2 checks each negative keyword for collateral damage (40% threshold). Phase 2B discovers up to 5 new negative keywords from sampled results. High-volume keywords use multi-sample scoring (3×50 leads, median). A final quality score (1-10) is computed, with retry on low scores. Auto-refine turns off when complete. Each keyword list uses its sourceCategories (max 3 per list) for accurate AI scoring.
API Documentation Sections
Introduction | Authentication | Rate Limits | User Profile | Leads | Filter Presets | Keyword Lists | Email Schedules | Export Formats | Export History | Account Settings | AI Features | Export Blacklist | Error Handling | Integrations
Ready to Find Your Next Customers? Get access to newly registered business leads updated daily. Start Free Trial