Create Lead Database Search

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"
}

POST

lead-database

searches

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"
}

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

X-API-Key

string

required

Your API key

Request Body

name

string

required

A name for this search (for your reference)

limit

number

required

Maximum number of leads to find (1-10000)

filters

object

required

Search filters to match leads. All filters are optional - combine as needed.

webhook_url

string

Optional URL to receive webhook when search completes

Filter Categories

Person Filters

filters.name

string

Free-text search by person name

filters.jobTitles

string[]

Job titles to include (e.g., ["CEO", "CTO", "Founder"])

filters.excludeJobTitles

string[]

Job titles to exclude

filters.skills

string[]

Professional skills to include (e.g., ["Python", "Machine Learning"])

filters.excludeSkills

string[]

Professional skills to exclude

filters.languages

string[]

Languages spoken (e.g., ["English", "Spanish"])

filters.excludeLanguages

string[]

Languages to exclude

filters.languageProficiency

string[]

Language proficiency levels (e.g., ["Native", "Fluent"])

filters.excludeLanguageProficiency

string[]

Language proficiency levels to exclude

filters.linkedinUsernames

string[]

LinkedIn usernames or profile URLs to include

filters.excludeLinkedinUsernames

string[]

LinkedIn usernames or profile URLs to exclude

filters.locations

string[]

Locations/countries to include (e.g., ["United States", "Canada"])

filters.excludeLocations

string[]

Locations/countries to exclude

filters.summaryKeywords

string[]

Keywords to search in profile summaries

filters.excludeSummaryKeywords

string[]

Keywords to exclude from profile summaries

filters.seniority

string[]

Seniority levels (e.g., ["C-Level", "Director", "VP", "Manager"])

filters.excludeSeniority

string[]

Seniority levels to exclude

filters.departments

string[]

Standard departments (e.g., ["Engineering", "Sales", "Marketing"])

filters.excludeDepartments

string[]

Departments to exclude

filters.experimentalDepartments

string[]

Experimental/emerging department classifications

filters.excludeExperimentalDepartments

string[]

Experimental departments to exclude

filters.certifications

string[]

Professional certifications (e.g., ["PMP", "AWS Certified"])

filters.excludeCertifications

string[]

Certifications to exclude

Experience Filters

filters.minTotalExperience

number

Minimum total professional experience in months

filters.maxTotalExperience

number

Maximum total professional experience in months

filters.minCurrentJobDuration

number

Minimum duration at current job in months

filters.maxCurrentJobDuration

number

Maximum duration at current job in months

Education Filters

filters.institutions

string[]

Educational institutions (e.g., ["Stanford University", "MIT"])

filters.excludeInstitutions

string[]

Institutions to exclude

filters.majors

string[]

Fields of study/majors (e.g., ["Computer Science", "Business"])

filters.excludeMajors

string[]

Majors to exclude

filters.educationKeywords

string[]

Keywords to search in education history

filters.excludeEducationKeywords

string[]

Education keywords to exclude

Company Filters

filters.companies

string[]

Company names to include (e.g., ["Google", "Microsoft"])

filters.excludeCompanies

string[]

Company names to exclude

filters.companyDomains

string[]

Company domains, comma-separated (e.g., ["google.com", "microsoft.com"])

filters.excludeCompanyDomains

string[]

Company domains to exclude

filters.companyLinkedinUsernames

string[]

Company LinkedIn usernames/URLs

filters.excludeCompanyLinkedinUsernames

string[]

Company LinkedIn usernames to exclude

filters.companyTypes

string[]

Company types (e.g., ["Public", "Private", "Non-Profit"])

filters.excludeCompanyTypes

string[]

Company types to exclude

filters.industries

string[]

Industries (e.g., ["Technology", "Healthcare", "Finance"])

filters.excludeIndustries

string[]

Industries to exclude

filters.experimentalIndustries

string[]

Experimental/emerging industry classifications

filters.excludeExperimentalIndustries

string[]

Experimental industries to exclude

filters.hqLocations

string[]

Company headquarters locations (e.g., ["San Francisco", "New York"])

filters.excludeHqLocations

string[]

HQ locations to exclude

filters.companySizes

string[]

Company size ranges (e.g., ["11-50", "51-200", "201-500"])

filters.excludeCompanySizes

string[]

Company sizes to exclude

filters.companyStatus

string

Company status: active or closed

filters.statusComments

string[]

Status comments to filter by

filters.publiclyListed

boolean

Filter for publicly listed companies only

filters.b2b

boolean

Filter for B2B companies only

Industry Codes

filters.sicCodes

string[]

SIC (Standard Industrial Classification) codes

filters.excludeSicCodes

string[]

SIC codes to exclude

filters.naicsCodes

string[]

NAICS (North American Industry Classification System) codes

filters.excludeNaicsCodes

string[]

NAICS codes to exclude

filters.keywords

string[]

General keywords to search for

filters.excludeKeywords

string[]

Keywords to exclude

Funding Filters

filters.lastFundingDateRange

string

Last funding date range: 30, 60, 90, or 90+ (days)

filters.fundingRoundNames

string[]

Funding round names (e.g., ["Series A", "Series B", "Seed"])

filters.ownershipStatus

string

Ownership status filter

filters.minFundingAmount

number

Minimum total funding amount (USD)

filters.maxFundingAmount

number

Maximum total funding amount (USD)

filters.ipoStartDate

string

IPO date range start (ISO 8601 format)

filters.ipoEndDate

string

IPO date range end (ISO 8601 format)

filters.acquisitionStartDate

string

Acquisition date range start (ISO 8601 format)

filters.acquisitionEndDate

string

Acquisition date range end (ISO 8601 format)

filters.minAnnualRevenue

number

Minimum annual revenue (USD)

filters.maxAnnualRevenue

number

Maximum annual revenue (USD)

Website Analytics Filters

filters.minMonthlyVisits

number

Minimum monthly website visits

filters.maxMonthlyVisits

number

Maximum monthly website visits

filters.minGlobalRanking

number

Minimum global website ranking

filters.maxGlobalRanking

number

Maximum global website ranking

filters.minCountryRanking

number

Minimum country-specific ranking

filters.maxCountryRanking

number

Maximum country-specific ranking

filters.minCategoryRanking

number

Minimum category ranking

filters.maxCategoryRanking

number

Maximum category ranking

filters.minBounceRate

number

Minimum bounce rate percentage (0-100)

filters.maxBounceRate

number

Maximum bounce rate percentage (0-100)

filters.minPagesPerVisit

number

Minimum pages per visit

filters.maxPagesPerVisit

number

Maximum pages per visit

filters.minVisitDuration

number

Minimum visit duration in seconds

filters.maxVisitDuration

number

Maximum visit duration in seconds

filters.websiteTopics

string[]

Website topics to include

filters.excludeWebsiteTopics

string[]

Website topics to exclude

Technology Filters

filters.technologies

string[]

Technologies used (e.g., ["React", "AWS", "Salesforce"])

filters.excludeTechnologies

string[]

Technologies to exclude

filters.hasPricing

boolean

Company has public pricing page

filters.hasDemo

boolean

Company offers product demos

filters.hasDocumentation

boolean

Company has public documentation

filters.hasFreeTrial

boolean

Company offers free trials

filters.hasDownloads

boolean

Company offers downloadable products

filters.hasMobileApps

boolean

Company has mobile applications

filters.hasOnlineReviews

boolean

Company has online reviews

Job Posting Filters

filters.jobPostingTitles

string[]

Job titles being recruited (e.g., ["Software Engineer", "Sales Manager"])

filters.excludeJobPostingTitles

string[]

Job posting titles to exclude

filters.jobPostingLocations

string[]

Job posting locations

filters.excludeJobPostingLocations

string[]

Job posting locations to exclude

filters.jobPostingFunctions

string[]

Job functions being recruited

filters.excludeJobPostingFunctions

string[]

Job functions to exclude

filters.jobPostingStartDate

string

Job posting date range start (ISO 8601 format)

filters.jobPostingEndDate

string

Job posting date range end (ISO 8601 format)

filters.jobPostingEmploymentType

string

Employment type (e.g., Full-time, Part-time, Contract)

filters.jobPostingSeniority

string

Job posting seniority level

Recommendation Filters

filters.recommendationKeywords

string[]

Keywords in LinkedIn recommendations

filters.excludeRecommendationKeywords

string[]

Recommendation keywords to exclude

filters.recommenderLinkedinUsernames

string[]

LinkedIn usernames of recommenders

filters.excludeRecommenderLinkedinUsernames

string[]

Recommender usernames to exclude

filters.minEmployeeSatisfaction

number

Minimum employee satisfaction score

filters.maxEmployeeSatisfaction

number

Maximum employee satisfaction score

Intent Filters

filters.bomboraIntentTopics

string[]

Bombora intent topics (e.g., ["Cloud Computing", "CRM Software"])

filters.intentScoreRanges

string[]

Intent score ranges to filter by

News Filters

filters.newsKeywords

string[]

Keywords in recent news articles

filters.excludeNewsKeywords

string[]

News keywords to exclude

Response

string

Unique identifier for the search

name

string

Name of the search

status

string

Current status: pending, processing, completed, failed

created_at

string

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.

Authorizations

X-API-Key

string

header

required

API key for authentication

Body

application/json

name

string

required

A name for this search (for your reference)

limit

integer

required

Maximum number of leads to find (1-10000)

Required range: 1 <= x <= 10000

filters

object

required

Comprehensive filters for Lead Database search (120+ filters available)

Show child attributes

webhook_url

string<uri>

Optional URL to receive webhook when search completes

Response

Search created successfully

string

required

Unique identifier for the search

name

string

required

Name of the search

status

enum<string>

required

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

Send Connection Request Get Search Status

Documentation Index

​Request

​Request Body

​Filter Categories

​Person Filters

​Experience Filters

​Education Filters

​Company Filters

​Industry Codes

​Funding Filters

​Website Analytics Filters

​Technology Filters

​Job Posting Filters

​Recommendation Filters

​Intent Filters

​News Filters

​Response

Authorizations

Body

Response

Request

Request Body

Filter Categories

Person Filters

Experience Filters

Education Filters

Company Filters

Industry Codes

Funding Filters

Website Analytics Filters

Technology Filters

Job Posting Filters

Recommendation Filters

Intent Filters

News Filters

Response