smb-sales-boost-leadsQuery and manage leads from the SMB Sales Boost B2B lead database. Search newly registered businesses, filter by location/industry/keywords, export leads, ma...
Install via ClawdBot CLI:
clawdbot install smb-sales-boost-leadsThis skill enables natural language interaction with the SMB Sales Boost API — a B2B lead generation platform providing access to newly registered small and medium businesses across the United States.
The user must provide their API key. Keys have a smbk_ prefix and are generated from the Dashboard > API tab. The key is passed as a Bearer token in the Authorization header of every request.
Base URL: https://smbsalesboost.com/api/v1
Important: API access requires a Pro, Platinum, Enterprise, or Agency subscription plan.
All requests must include:
Authorization: Bearer <API_KEY>If the user hasn't provided their API key yet, ask them for it before making any requests. Store it in a variable for reuse throughout the session.
Rate limit headers are returned on every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset. If rate limited, check the Retry-After header for seconds to wait.
SMB Sales Boost has two separate databases with different contact information available:
home_improvement — Home improvement/contractor businesses with phone numbers, star ratings, review counts, review snippets, profile URLs, and categoriesother — General newly registered businesses with phone numbers and email addresses, registered URLs, crawled URLs, short/long descriptions, and redirect statusThe Home Improvement database provides phone numbers as the primary contact method. The Other database provides both phone numbers and email addresses, making it ideal for cold email and multi-channel outreach campaigns.
Some filter parameters only work with one database type. The user's account has a default database setting. Always check which database the user wants to query.
GET /leadsThe primary endpoint. Translates natural language queries into filtered lead searches.
Key Parameters:
| Parameter | Type | Description |
|-----------|------|-------------|
| page | integer | Page number (default: 1) |
| limit | integer | Results per page (max 1000, default 100) |
| database | string | home_improvement or other |
| positiveKeywords | JSON array string | Keywords to include (OR logic). Supports wildcard for pattern matching (e.g., ["dental", "ortho*"]). Without wildcards, performs substring matching by default. |
| negativeKeywords | JSON array string | Keywords to exclude (AND logic). Also supports wildcard (e.g., ["franchise*"]). |
| orColumns | JSON array string | Column names to search keywords against |
| stateInclude | string | Comma-separated state codes: CA,NY,TX |
| stateExclude | string | Comma-separated state codes to exclude |
| cityInclude | JSON array string | Cities to include |
| cityExclude | JSON array string | Cities to exclude |
| zipInclude | JSON array string | ZIP codes to include |
| zipExclude | JSON array string | ZIP codes to exclude |
| nameIncludeTerms | JSON array string | Business name include terms |
| nameExcludeTerms | JSON array string | Business name exclude terms |
| lastUpdatedFrom | date string | Filter by Last Updated date (after this date) |
| lastUpdatedTo | date string | Filter by Last Updated date (before this date) |
Understanding "Last Updated" — this is critical for finding the freshest leads:
| Parameter | Type | Description |
|-----------|------|-------------|
| countryInclude | JSON array string | Countries to include |
| countryExclude | JSON array string | Countries to exclude |
| sortBy | string | Field to sort by |
| sortOrder | string | asc or desc (default: desc) |
Wildcard Keyword Tips:
"dental*" matches "dental clinic", "pediatric dentistry", etc."autorepair*" matches "auto body repair", "automotive repair shop", etc.["dental", "dentist", "orthodont"]Home Improvement Only:
| Parameter | Type | Description |
|-----------|------|-------------|
| minStars / maxStars | number | Star rating range |
| minReviewCount / maxReviewCount | integer | Review count range |
| categoriesIncludeTerms / categoriesExcludeTerms | JSON array string | Category filters |
| reviewSnippetIncludeTerms / reviewSnippetExcludeTerms | JSON array string | Review text filters |
| profileUrlIncludeTerms / profileUrlExcludeTerms | JSON array string | Profile URL filters |
Other Database Only:
| Parameter | Type | Description |
|-----------|------|-------------|
| urlIncludeTerms / urlExcludeTerms | JSON array string | Registered URL filters |
| crawledUrlIncludeTerms / crawledUrlExcludeTerms | JSON array string | Crawled URL filters |
| descriptionIncludeTerms / descriptionExcludeTerms | JSON array string | Short description filters |
| descriptionLongIncludeTerms / descriptionLongExcludeTerms | JSON array string | Long description filters |
| emailPrimaryInclude / emailPrimaryExclude | JSON array string | Primary email filters |
| phonePrimaryInclude / phonePrimaryExclude | JSON array string | Primary phone filters |
| redirectFilter | string | yes or no — filter by redirect status |
Important: At least one positive filter is required (positiveKeywords or any column-specific include terms).
Response includes: leads array, totalCount, page, limit, databaseType
Lead fields: id, companyName, state, city, zip, phone, email, categories, lastUpdated (phone/email masked for free users). The lastUpdated field indicates when contact information was last detected or updated — this is the best indicator of lead freshness and actionability.
POST /leads/exportExport filtered leads as CSV, JSON, or XLSX files.
Request body:
{
"database": "home_improvement" | "other",
"filters": { /* same filter params as GET /leads */ },
"selectedIds": [1, 2, 3], // alternative to filters
"formatId": 123 // optional export format template ID
}Response: files array (with base64-encoded data), leadCount, exportId, databaseType
Rate limited: 1 export per 5 minutes, max 10,000 leads per export.
/filter-presetsGET /filter-presets — List all saved presetsPOST /filter-presets — Create a preset (requires name and filters object)DELETE /filter-presets/{id} — Delete a preset/keyword-listsGET /keyword-lists — List all keyword listsPOST /keyword-lists — Create (requires name, optional keywords and negativeKeywords arrays)PUT /keyword-lists/{id} — UpdateDELETE /keyword-lists/{id} — Delete/email-schedulesGET /email-schedules — List schedulesPOST /email-schedules — Create (requires name, filterPresetId, intervalValue, intervalUnit)PATCH /email-schedules/{id} — Update (supports isActive toggle)DELETE /email-schedules/{id} — DeletePOST /email-schedules/{id}/trigger — Manually trigger an active schedule to send immediately (rate limited: 1 per 5 minutes)/export-formatsGET /export-formats — List custom export formatsPOST /export-formats — Create (requires name, supports fileType, fieldMappings, split settings)GET /export-formats/{id} — Get specific formatPATCH /export-formats/{id} — UpdateDELETE /export-formats/{id} — DeletePOST /export-formats/{id}/set-default — Set as default/export-historyGET /export-history — List past exports (optional limit param, default 50)GET /export-history/{id}/download — Re-download (expires after 7 days)POST /ai/suggest-categories — Get AI category suggestions based on company profile.
Required: companyName, companyDescription, productService
Optional: companyWebsite, smbType, excludeCategories
POST /ai/generate-keywords — Trigger async keyword generation based on profile and target categories.
GET /ai/keyword-status — Check the status of keyword generation jobs. Use this to poll for completion after triggering keyword generation.
AI Auto-Refine — Automatically refine keyword lists using AI:
POST /ai/auto-refine/enable — Enable auto-refine for a keyword list (requires listId)POST /ai/auto-refine/disable — Disable auto-refine for a keyword list (requires listId)GET /ai/auto-refine/status — Check auto-refine status (optional listId query param to filter by specific list)/export-blacklistGET /export-blacklist — List blacklisted entriesPOST /export-blacklist — Add entry (single or batch via entries array)DELETE /export-blacklist/{id} — Remove entryGET /me — Get user profile (subscription, settings, onboarding status)PATCH /me — Update profile (firstName, lastName, companyName, companyWebsite)GET /settings/database — Check current database type and switch availabilityPOST /settings/switch-database — Switch between databases (has cooldown)When users make natural language requests, translate them into API calls. Use multiple wildcard keyword variations to cast a wider net — keywords are matched via OR logic so more variations means better coverage:
| User Says | API Call |
|-----------|---------|
| "Find new dental practices in Texas" | GET /leads?positiveKeywords=["dental","dentist","orthodont"]&stateInclude=TX |
| "Search for med spas and aesthetics businesses in Florida" | GET /leads?positiveKeywords=["medspa","medicalspa","aesthet","botox","medspa"]&stateInclude=FL |
| "Show me auto repair shops in Chicago updated this week" | GET /leads?positiveKeywords=["autorepair","bodyshop","mechanic","oilchange","brake*"]&cityInclude=["Chicago"]&lastUpdatedFrom=2026-02-14 |
| "Find pet grooming businesses in California, exclude boarding" | GET /leads?positiveKeywords=["petgroom","doggroom","petsalon"]&negativeKeywords=["boarding","kennel*"]&stateInclude=CA |
| "Get bakeries and catering companies in New York" | GET /leads?positiveKeywords=["bakery","bakeshop","cater","pastry","cake*"]&stateInclude=NY |
| "Find fitness studios in Georgia and North Carolina" | GET /leads?positiveKeywords=["fitness","gym","yoga","pilates","crossfit"]&stateInclude=GA,NC |
| "Get 50 leads with high ratings" | GET /leads?limit=50&minStars=4 (home_improvement only) |
| "Export all my filtered results" | POST /leads/export with current filters |
| "What categories should I target?" | POST /ai/suggest-categories |
| "Save this search as 'FL Med Spas'" | POST /filter-presets |
| "Show my recent exports" | GET /export-history |
| "What plan am I on?" | GET /me |
| "Exclude these domains from exports" | POST /export-blacklist |
| "Enable auto-refine on my keyword list" | POST /ai/auto-refine/enable with listId |
| "Check on my keyword generation" | GET /ai/keyword-status |
| "Send my scheduled email now" | POST /email-schedules/{id}/trigger |
Use the included smb_api.py script for all API calls. It handles authentication, URL encoding, response parsing, and safe file export in a single reusable file. Do not use shell commands like curl — constructing shell commands from user-provided input risks shell injection vulnerabilities.
python smb_api.py <API_KEY> <METHOD> <ENDPOINT> [--params '{"key":"value"}'] [--body '{"key":"value"}'] [--output-dir /path/to/dir]# Search for med spas in Florida using wildcard keywords (OR logic)
python smb_api.py smbk_xxx GET /leads --params '{"positiveKeywords":"[\"*med*spa*\",\"*medical*spa*\",\"*aesthet*\",\"*botox*\",\"*medspa*\"]","stateInclude":"FL","limit":"25"}'
# Find auto shops in multiple states, exclude franchises
python smb_api.py smbk_xxx GET /leads --params '{"positiveKeywords":"[\"*auto*repair*\",\"*body*shop*\",\"*mechanic*\",\"*tire*\",\"*oil*change*\"]","negativeKeywords":"[\"*franchise*\",\"*jiffy*\"]","stateInclude":"GA,FL,NC,SC,TN","limit":"50"}'
# Search for recently updated dental leads in Texas
python smb_api.py smbk_xxx GET /leads --params '{"positiveKeywords":"[\"*dental*\",\"*dentist*\",\"*orthodont*\",\"*oral*surg*\"]","stateInclude":"TX","lastUpdatedFrom":"2026-02-14"}'
# Get account info
python smb_api.py smbk_xxx GET /me
# Export pet industry leads (files saved automatically to --output-dir)
python smb_api.py smbk_xxx POST /leads/export --body '{"database":"other","filters":{"positiveKeywords":["*pet*groom*","*veterinar*","*dog*train*","*pet*board*"],"stateInclude":"CA,OR,WA"}}'
# AI category suggestions for a fitness equipment distributor
python smb_api.py smbk_xxx POST /ai/suggest-categories --body '{"companyName":"FitPro Supply","companyDescription":"Commercial fitness equipment distributor","productService":"Gym equipment, treadmills, weight systems"}'
# Create a filter preset for bakery/catering leads
python smb_api.py smbk_xxx POST /filter-presets --body '{"name":"NY Bakeries","filters":{"positiveKeywords":["*bakery*","*bake*shop*","*cater*","*pastry*"],"stateInclude":"NY"}}'
# Enable AI auto-refine on a keyword list
python smb_api.py smbk_xxx POST /ai/auto-refine/enable --body '{"listId":42}'
# Check auto-refine status for a specific list
python smb_api.py smbk_xxx GET /ai/auto-refine/status --params '{"listId":"42"}'
# Check keyword generation job status
python smb_api.py smbk_xxx GET /ai/keyword-status
# Manually trigger an email schedule
python smb_api.py smbk_xxx POST /email-schedules/15/trigger
# Delete a filter preset
python smb_api.py smbk_xxx DELETE /filter-presets/42The script outputs JSON to stdout and rate limit headers to stderr. For export requests, files are automatically saved with sanitized filenames.
Remember:
["dental", "dentist", "orthodont"] not just ["dental"]) — keywords are matched via OR logic"autorepair" matches "auto body repair", "automotive repair shop", etc.--params JSONThis skill addresses two specific agent execution risks: shell injection from constructing CLI commands with user input, and arbitrary file writes from unsanitized API-provided filenames.
Shell injection prevention: The smb_api.py script uses Python's requests library for all HTTP calls. User-provided search terms, locations, and other inputs are passed as structured function arguments — never interpolated into shell command strings. This eliminates the shell injection vector that exists when agents construct curl commands from user input.
Path traversal prevention in exports: The /leads/export endpoint returns base64-encoded files with an API-provided fileName field. A malicious or corrupted filename (e.g., ../../etc/passwd) could write files to arbitrary locations. The script enforces three safeguards:
os.path.basename() strips all directory components — ../../etc/passwd becomes passwd.csv, .json, and .xlsx extensions are allowed; anything else defaults to .csv/mnt/user-data/outputs/ by default), never to user-specified or API-specified pathsAPI key handling: The key is passed as a CLI argument and sent only in the Authorization header. It is never logged, written to files, or included in error output.
| Status | Meaning |
|--------|---------|
| 400 | Bad request — check parameters |
| 401 | Invalid or missing API key |
| 403 | Active subscription required |
| 404 | Resource not found |
| 429 | Rate limited — check Retry-After header |
| 500 | Server error |
All errors return: { "error": "error_code", "message": "Human-readable message" }
AI Usage Analysis
Analysis is being generated… refresh in a few seconds.
HubSpot CRM and CMS API integration for contacts, companies, deals, owners, and content management.
Partnership outreach, market research, competitor analysis, and proposal generation. Transform your AI agent into a strategic business development partner that identifies and cultivates growth opportunities.
CRM integration, lead tracking, outreach automation, and pipeline management. Transform your AI agent into a sales assistant that never lets leads slip through the cracks.
Manage Zhihu AI Bot to publish, like/unlike, comment, delete comments, and fetch ring or comment details using Zhihu API credentials.
ActiveCampaign CRM integration for lead management, deal tracking, and email automation. Use for syncing demo leads, managing clinic sales pipeline, and triggering follow-up sequences.
Query and analyze brand mentions from Octolens API. Use when the user wants to fetch mentions, track keywords, filter by source platforms (Twitter, Reddit, GitHub, LinkedIn, etc.), sentiment analysis, or analyze social media engagement. Supports complex filtering with AND/OR logic, date ranges, follower counts, and bookmarks.