Leads - SMB Sales Boost API
Search, filter, and export leads from our database. Supports keyword filtering, location filtering, industry filtering, and pagination.
How Search Works: Two-Phase Query Model
Phase 1 - Include (OR Logic)
All positive keywords and include terms are combined with OR logic. A lead matches if any positive keyword matches in any of the OR group search columns.
- Home Improvement
- Business Name, Categories, Profile URL
- Other
- Registered URL, Crawled URL, Company Name, Categories (AI Enrichment)
Phase 2 - Exclude (AND Logic)
Negative keywords are checked against the same columns as positive keywords. A lead is excluded if any negative keyword matches in any of those columns.
URL Space-to-Wildcard
For URL columns, spaces in search terms are automatically replaced with % wildcards. For example, "dental clinic" becomes %dental%clinic% to match URLs like example.com/dental-clinic.
AI Category Estimation (Other Database)
Leads in the Other database are progressively enriched by AI with estimated business type categories. Each lead may include an aiCategoryEstimation field containing an array of 1-3 category names, or null if not yet classified.
Endpoints
GET /api/v1/leads- Search and filter leads. Requires at least one positive filter (positiveKeywords, nameIncludeTerms, etc.).
POST /api/v1/leads/export- Export filtered leads to CSV, JSON, or XLSX. Subject to export rate limits. Supports credit-optimized ordering via maxCredits and maxResults parameters.
Key Parameters
positiveKeywords (required), negativeKeywords, orColumns, stateInclude, stateExclude, cityInclude, cityExclude, zipInclude, zipExclude, minStars, maxStars, minReviewCount, maxReviewCount, sortBy, sortOrder, page, limit, database, and various column-specific include/exclude terms.
Credit-Optimized Export Parameters
The export endpoint supports additional parameters for controlling credit usage:
maxLeads- Cap total leads exported. Overflow stored in lead reservoir for the next export.
maxResults- Cap total results returned (both new and previously-exported leads). New leads are prioritized first, then previously-exported leads fill remaining slots.
maxCredits- Cap credits spent on this export. Only new (credit-consuming) leads count toward this cap. Set to 0 to only receive previously-exported leads at no credit cost.
When maxCredits or maxResults is specified, leads are returned in credit-optimized order: new leads (credit-consuming) sorted first, then previously-exported leads, each group sorted by lastUpdated descending (or your custom sort).
API Documentation Sections
Introduction | Programmatic Purchase | Authentication | Rate Limits | User Profile | Leads | Filter Presets | Keyword Lists | Email Schedules | Export Formats | Export History | Account Settings | AI Features | Export Blacklist | Error Handling | Credits & Subscription | MCP Server | Integrations
Ready to Find Your Next Customers? Get access to newly registered business leads updated daily. Get Started