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.

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.

API Documentation Sections

View Full API Documentation

Ready to Find Your Next Customers? Get access to newly registered business leads updated daily. Start Free Trial