Keyword Lists - SMB Sales Boost API
Manage keyword lists for targeted lead searching. Create lists of include and exclude keywords to refine your lead searches and automate filtering.
3-Category Limit
Each keyword list targets up to 3 categories (stored in the sourceCategories field). This is intentional — the AI produces better-focused keyword lists for tightly scoped category sets. If you need more categories, create separate keyword lists for each group of up to 3.
Endpoints
GET /api/v1/keyword-lists- List all your keyword lists.
POST /api/v1/keyword-lists- Create a new keyword list. Requires name, type (positive/negative), and keywords array. Optionally include sourceCategories (max 3).
PUT /api/v1/keyword-lists/:id- Update an existing keyword list. You can update keywords, name, and sourceCategories (max 3).
DELETE /api/v1/keyword-lists/:id- Delete a keyword list by ID.
Keyword List Object
Each list includes: id, name, type (positive or negative), keywords array, sourceCategories (up to 3 target categories), autoRefineEnabled, refinementStatus, pairedListId, and createdAt timestamp.
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