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": {
      "job_titles": ["CEO", "CTO", "Founder"],
      "locations": ["United States"],
      "industries": ["Technology", "Software"],
      "company_sizes": ["11-50", "51-200"],
      "seniority_levels": ["C-Level", "VP"],
      "min_total_experience_duration_months": 60,
      "technologies_used": ["AWS", "React"]
    }
  }'

const response = await fetch('https://api.sendpilot.ai/v1/lead-database/searches', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.SENDPILOT_API_KEY,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Tech Founders Q1 2024',
    limit: 100,
    filters: {
      job_titles: ['CEO', 'CTO', 'Founder'],
      locations: ['United States'],
      industries: ['Technology', 'Software'],
      company_sizes: ['11-50', '51-200'],
      seniority_levels: ['C-Level', 'VP'],
      min_total_experience_duration_months: 60,
      technologies_used: ['AWS', 'React']
    }
  })
});
const data = await response.json();

import requests

response = requests.post(
    'https://api.sendpilot.ai/v1/lead-database/searches',
    headers={
        'X-API-Key': 'YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'name': 'Tech Founders Q1 2024',
        'limit': 100,
        'filters': {
            'job_titles': ['CEO', 'CTO', 'Founder'],
            'locations': ['United States'],
            'industries': ['Technology', 'Software'],
            'company_sizes': ['11-50', '51-200'],
            'seniority_levels': ['C-Level', 'VP'],
            'min_total_experience_duration_months': 60,
            'technologies_used': ['AWS', 'React']
        }
    }
)
data = response.json()

{
  "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": {
      "job_titles": ["CEO", "CTO", "Founder"],
      "locations": ["United States"],
      "industries": ["Technology", "Software"],
      "company_sizes": ["11-50", "51-200"],
      "seniority_levels": ["C-Level", "VP"],
      "min_total_experience_duration_months": 60,
      "technologies_used": ["AWS", "React"]
    }
  }'

const response = await fetch('https://api.sendpilot.ai/v1/lead-database/searches', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.SENDPILOT_API_KEY,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Tech Founders Q1 2024',
    limit: 100,
    filters: {
      job_titles: ['CEO', 'CTO', 'Founder'],
      locations: ['United States'],
      industries: ['Technology', 'Software'],
      company_sizes: ['11-50', '51-200'],
      seniority_levels: ['C-Level', 'VP'],
      min_total_experience_duration_months: 60,
      technologies_used: ['AWS', 'React']
    }
  })
});
const data = await response.json();

import requests

response = requests.post(
    'https://api.sendpilot.ai/v1/lead-database/searches',
    headers={
        'X-API-Key': 'YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'name': 'Tech Founders Q1 2024',
        'limit': 100,
        'filters': {
            'job_titles': ['CEO', 'CTO', 'Founder'],
            'locations': ['United States'],
            'industries': ['Technology', 'Software'],
            'company_sizes': ['11-50', '51-200'],
            'seniority_levels': ['C-Level', 'VP'],
            'min_total_experience_duration_months': 60,
            'technologies_used': ['AWS', 'React']
        }
    }
)
data = response.json()

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

string

required

Your API key

Request Body

string

required

A name for this search (for your reference)

number

required

Maximum number of leads to find. There is no hard limit; results are capped by available credits.

object

required

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

Download the complete list of supported filter values here: lead-database-filter-values.json

string

Optional HTTPS URL to receive a completion notification when the search completes. Must be a public host.

Filter Categories

Person Filters

string

Free-text search by person name

string[]

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

string[]

Job titles to exclude

string[]

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

string[]

Professional skills to exclude

string[]

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

string[]

Languages to exclude

string[]

Language proficiency levels (e.g., ["english-5"])

string[]

Language proficiency levels to exclude

string[]

LinkedIn usernames or profile URLs to include

string[]

LinkedIn usernames or profile URLs to exclude

string[]

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

string[]

Locations/countries to exclude

string[]

Keywords to search in profile summaries

string[]

Keywords to exclude from profile summaries

string[]

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

string[]

Seniority levels to exclude

string[]

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

string[]

Departments to exclude

string[]

Experimental/emerging department classifications

string[]

Experimental departments to exclude

string[]

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

string[]

Certifications to exclude

Experience Filters

number

Minimum total professional experience in months

number

Maximum total professional experience in months

number

Minimum duration at current job in months

number

Maximum duration at current job in months

Education Filters

string[]

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

string[]

Institutions to exclude

string[]

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

string[]

Majors to exclude

string[]

Keywords to search in education history

string[]

Education keywords to exclude

Company Filters

string[]

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

string[]

Company names to exclude

string

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

string

Company domains to exclude, comma-separated

string[]

Company LinkedIn usernames/URLs

string[]

Company LinkedIn usernames to exclude

string[]

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

string[]

Company types to exclude

string[]

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

string[]

Industries to exclude

string[]

Experimental/emerging industry classifications

string[]

Experimental industries to exclude

string[]

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

string[]

HQ locations to exclude

string[]

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

number[]

Company sizes to exclude using mapped integer values

string

Company status: active or closed

string[]

Status comments to filter by

boolean

Filter for publicly listed companies only

boolean

Filter for B2B companies only

Industry Codes

object[]

SIC (Standard Industrial Classification) codes

string[]

SIC codes to exclude

object[]

NAICS (North American Industry Classification System) codes

string[]

NAICS codes to exclude

string[]

General keywords to search for

string[]

Keywords to exclude

Funding Filters

string

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

string[]

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

string[]

Ownership status filter

number

Minimum funding amount

number

Maximum funding amount

string

IPO date range start (dd/mm/yyyy)

string

IPO date range end (dd/mm/yyyy)

string

Acquisition date range start (dd/mm/yyyy)

string

Acquisition date range end (dd/mm/yyyy)

number

Minimum annual revenue

number

Maximum annual revenue

Website Analytics Filters

number

Minimum monthly website visits

number

Maximum monthly website visits

number

Minimum global website ranking

number

Maximum global website ranking

number

Minimum country-specific ranking

number

Maximum country-specific ranking

number

Minimum category ranking

number

Maximum category ranking

number

Minimum bounce rate percentage

number

Maximum bounce rate percentage

number

Minimum pages per visit

number

Maximum pages per visit

number

Minimum visit duration in seconds

number

Maximum visit duration in seconds

string[]

Website topics to include

string[]

Website topics to exclude

Technology Filters

string[]

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

string[]

Technologies to exclude

boolean

Company has public pricing page

boolean

Company offers product demos

boolean

Company has public documentation

boolean

Company offers free trials

boolean

Company offers downloadable products

boolean

Company has mobile applications

boolean

Company has online reviews

Job Posting Filters

string[]

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

string[]

Job posting titles to exclude

string[]

Job posting locations

string[]

Job posting locations to exclude

string[]

Job functions being recruited

string[]

Job functions to exclude

string

Job posting date range start (dd/mm/yyyy)

string

Job posting date range end (dd/mm/yyyy)

string[]

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

string[]

Job posting seniority level

Recommendation Filters

string[]

Keywords in LinkedIn recommendations

string[]

Recommendation keywords to exclude

string[]

LinkedIn usernames of recommenders

string[]

Recommender usernames to exclude

number

Minimum employee satisfaction score

number

Maximum employee satisfaction score

Intent Filters

string[]

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

string[]

Intent score ranges to filter by

News Filters

string[]

Keywords in recent news articles

string[]

News keywords to exclude

Response

string

Unique identifier for the search

string

Name of the search

string

Current status: pending, processing, completed, failed

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": {
      "job_titles": ["CEO", "CTO", "Founder"],
      "locations": ["United States"],
      "industries": ["Technology", "Software"],
      "company_sizes": ["11-50", "51-200"],
      "seniority_levels": ["C-Level", "VP"],
      "min_total_experience_duration_months": 60,
      "technologies_used": ["AWS", "React"]
    }
  }'

const response = await fetch('https://api.sendpilot.ai/v1/lead-database/searches', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.SENDPILOT_API_KEY,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Tech Founders Q1 2024',
    limit: 100,
    filters: {
      job_titles: ['CEO', 'CTO', 'Founder'],
      locations: ['United States'],
      industries: ['Technology', 'Software'],
      company_sizes: ['11-50', '51-200'],
      seniority_levels: ['C-Level', 'VP'],
      min_total_experience_duration_months: 60,
      technologies_used: ['AWS', 'React']
    }
  })
});
const data = await response.json();

import requests

response = requests.post(
    'https://api.sendpilot.ai/v1/lead-database/searches',
    headers={
        'X-API-Key': 'YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'name': 'Tech Founders Q1 2024',
        'limit': 100,
        'filters': {
            'job_titles': ['CEO', 'CTO', 'Founder'],
            'locations': ['United States'],
            'industries': ['Technology', 'Software'],
            'company_sizes': ['11-50', '51-200'],
            'seniority_levels': ['C-Level', 'VP'],
            'min_total_experience_duration_months': 60,
            'technologies_used': ['AWS', 'React']
        }
    }
)
data = response.json()

{
  "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 excluded_* 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. All filters are optional and can be combined.

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

Getting Started

Credits

Campaigns

Leads

Inbox

Lead Database

Lead Extractor

Webhooks

Webhook Events

Use Cases

Create Lead Database Search

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

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