Documentation Index
Fetch the complete documentation index at: https://docs.sendpilot.ai/llms.txt
Use this file to discover all available pages before exploring further.
Initiates a bulk search in the Lead Database to find leads matching your specified filters. The API supports 120+ filters across multiple categories for precise lead targeting.
Request
Request Body
A name for this search (for your reference)
Maximum number of leads to find (1-10000)
Search filters to match leads. All filters are optional - combine as needed.
Optional URL to receive webhook when search completes
Filter Categories
Person Filters
Free-text search by person name
Job titles to include (e.g., ["CEO", "CTO", "Founder"])
Professional skills to include (e.g., ["Python", "Machine Learning"])
Professional skills to exclude
Languages spoken (e.g., ["English", "Spanish"])
filters.languageProficiency
Language proficiency levels (e.g., ["Native", "Fluent"])
filters.excludeLanguageProficiency
Language proficiency levels to exclude
filters.linkedinUsernames
LinkedIn usernames or profile URLs to include
filters.excludeLinkedinUsernames
LinkedIn usernames or profile URLs to exclude
Locations/countries to include (e.g., ["United States", "Canada"])
Locations/countries to exclude
Keywords to search in profile summaries
filters.excludeSummaryKeywords
Keywords to exclude from profile summaries
Seniority levels (e.g., ["C-Level", "Director", "VP", "Manager"])
Seniority levels to exclude
Standard departments (e.g., ["Engineering", "Sales", "Marketing"])
filters.excludeDepartments
Departments to exclude
filters.experimentalDepartments
Experimental/emerging department classifications
filters.excludeExperimentalDepartments
Experimental departments to exclude
Professional certifications (e.g., ["PMP", "AWS Certified"])
filters.excludeCertifications
Certifications to exclude
Experience Filters
filters.minTotalExperience
Minimum total professional experience in months
filters.maxTotalExperience
Maximum total professional experience in months
filters.minCurrentJobDuration
Minimum duration at current job in months
filters.maxCurrentJobDuration
Maximum duration at current job in months
Education Filters
Educational institutions (e.g., ["Stanford University", "MIT"])
filters.excludeInstitutions
Institutions to exclude
Fields of study/majors (e.g., ["Computer Science", "Business"])
filters.educationKeywords
Keywords to search in education history
filters.excludeEducationKeywords
Education keywords to exclude
Company Filters
Company names to include (e.g., ["Google", "Microsoft"])
Company domains, comma-separated (e.g., ["google.com", "microsoft.com"])
filters.excludeCompanyDomains
Company domains to exclude
filters.companyLinkedinUsernames
Company LinkedIn usernames/URLs
filters.excludeCompanyLinkedinUsernames
Company LinkedIn usernames to exclude
Company types (e.g., ["Public", "Private", "Non-Profit"])
filters.excludeCompanyTypes
Company types to exclude
Industries (e.g., ["Technology", "Healthcare", "Finance"])
filters.excludeIndustries
Industries to exclude
filters.experimentalIndustries
Experimental/emerging industry classifications
filters.excludeExperimentalIndustries
Experimental industries to exclude
Company headquarters locations (e.g., ["San Francisco", "New York"])
filters.excludeHqLocations
HQ locations to exclude
Company size ranges (e.g., ["11-50", "51-200", "201-500"])
filters.excludeCompanySizes
Company sizes to exclude
Company status: active or closed
Status comments to filter by
Filter for publicly listed companies only
Filter for B2B companies only
Industry Codes
SIC (Standard Industrial Classification) codes
NAICS (North American Industry Classification System) codes
filters.excludeNaicsCodes
NAICS codes to exclude
General keywords to search for
Funding Filters
filters.lastFundingDateRange
Last funding date range: 30, 60, 90, or 90+ (days)
filters.fundingRoundNames
Funding round names (e.g., ["Series A", "Series B", "Seed"])
Minimum total funding amount (USD)
Maximum total funding amount (USD)
IPO date range start (ISO 8601 format)
IPO date range end (ISO 8601 format)
filters.acquisitionStartDate
Acquisition date range start (ISO 8601 format)
filters.acquisitionEndDate
Acquisition date range end (ISO 8601 format)
Minimum annual revenue (USD)
Maximum annual revenue (USD)
Website Analytics Filters
Minimum monthly website visits
Maximum monthly website visits
Minimum global website ranking
Maximum global website ranking
filters.minCountryRanking
Minimum country-specific ranking
filters.maxCountryRanking
Maximum country-specific ranking
filters.minCategoryRanking
Minimum category ranking
filters.maxCategoryRanking
Maximum category ranking
Minimum bounce rate percentage (0-100)
Maximum bounce rate percentage (0-100)
Minimum visit duration in seconds
Maximum visit duration in seconds
Website topics to include
filters.excludeWebsiteTopics
Website topics to exclude
Technology Filters
Technologies used (e.g., ["React", "AWS", "Salesforce"])
filters.excludeTechnologies
Technologies to exclude
Company has public pricing page
Company offers product demos
Company has public documentation
Company offers free trials
Company offers downloadable products
Company has mobile applications
Company has online reviews
Job Posting Filters
Job titles being recruited (e.g., ["Software Engineer", "Sales Manager"])
filters.excludeJobPostingTitles
Job posting titles to exclude
filters.jobPostingLocations
Job posting locations
filters.excludeJobPostingLocations
Job posting locations to exclude
filters.jobPostingFunctions
Job functions being recruited
filters.excludeJobPostingFunctions
Job functions to exclude
filters.jobPostingStartDate
Job posting date range start (ISO 8601 format)
filters.jobPostingEndDate
Job posting date range end (ISO 8601 format)
filters.jobPostingEmploymentType
Employment type (e.g., Full-time, Part-time, Contract)
filters.jobPostingSeniority
Job posting seniority level
Recommendation Filters
filters.recommendationKeywords
Keywords in LinkedIn recommendations
filters.excludeRecommendationKeywords
Recommendation keywords to exclude
filters.recommenderLinkedinUsernames
LinkedIn usernames of recommenders
filters.excludeRecommenderLinkedinUsernames
Recommender usernames to exclude
filters.minEmployeeSatisfaction
Minimum employee satisfaction score
filters.maxEmployeeSatisfaction
Maximum employee satisfaction score
Intent Filters
filters.bomboraIntentTopics
Bombora intent topics (e.g., ["Cloud Computing", "CRM Software"])
filters.intentScoreRanges
Intent score ranges to filter by
News Filters
Keywords in recent news articles
filters.excludeNewsKeywords
News keywords to exclude
Response
Unique identifier for the search
Current status: pending, processing, completed, failed
ISO 8601 timestamp when the search was created
curl -X POST "https://api.sendpilot.ai/v1/lead-database/searches" \
-H "X-API-Key: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"name": "Tech Founders Q1 2024",
"limit": 100,
"filters": {
"jobTitles": ["CEO", "CTO", "Founder"],
"locations": ["United States"],
"industries": ["Technology", "Software"],
"companySizes": ["11-50", "51-200"],
"seniority": ["C-Level", "VP"],
"minTotalExperience": 60,
"technologies": ["AWS", "React"]
}
}'
{
"id": "search_abc123xyz",
"name": "Tech Founders Q1 2024",
"status": "pending",
"created_at": "2024-02-24T10:30:00.000Z"
}
All filters are optional and can be combined. Use exclude* variants to explicitly remove matches. Array filters use OR logic within the same filter and AND logic across different filters.
API key for authentication
A name for this search (for your reference)
Maximum number of leads to find (1-10000)
Required range: 1 <= x <= 10000
Comprehensive filters for Lead Database search (120+ filters available)
Optional URL to receive webhook when search completes
Search created successfully
Unique identifier for the search
Current status of the search
Available options:
pending,
processing,
completed,
failed
created_at
string<date-time>
required
ISO 8601 timestamp when the search was created