Prospects search

POST /api/v1/public/prospects/search/

Search and filter prospects or companies using flexible filters. This endpoint allows you to find leads based on various criteria before adding them to a lead list.

Auth: X-API-Key
Method: POST

Request Body

{
  "search_type": "PEOPLE",
  "page": 1,
  "page_size": 25,
  "filters": {
    "job_title": "VP",
    "industry": "Technology",
    "company_size": "51-200",
    "prospect_location": "United States"
  }
}

Note: Filter values can be strings, arrays, or objects with include/exclude logic. See Filter Options below for details.

Parameters

Parameter	Type	Required	Default	Description
`search_type`	string	No	`PEOPLE`	Either `PEOPLE` or `COMPANY` to specify what type of leads to search for
`page`	integer	No	`1`	Page number for pagination
`page_size`	integer	No	`25`	Number of results per page (max 100)
`filters`	object	No	`{}`	Filter criteria (see below)

Filters can be passed as:

Strings: "VP" - Will search for this single value
Arrays: ["VP", "Director"] - Will search for any of these values
Objects: {"must": ["VP"], "doesnt": ["Intern"]} - For include/exclude logic

For People Search (`search_type: "PEOPLE"`)

Filter	Type	Description	Example Values
`job_title`	string/array	Job title(s) to search for	`"VP"`, `["CEO", "Founder"]`
`seniority`	string/array	Seniority/management level	`"VP"`, `["Director", "C-Level", "VP"]`
`department`	string/array	Department/function	`"Sales"`, `["Sales", "Marketing"]`
`company_name`	string/array/object	Company name(s)	`"Microsoft"`, `["Google", "Apple"]`, `{"must": ["Tech"], "doesnt": ["Corp"]}`
`company_size`	string/array	Company size range	`"51-200"`, `["51-200", "201-500"]`
`industry`	string/array	Industry sector	`"Technology"`, `["Technology", "Software"]`
`prospect_location`	string/array	Geographic location	`"San Francisco, CA, United States"`, `["New York", "Los Angeles"]`
`location_radius`	integer	Radius for location search (in km or mi)	`25`, `50`
`location_radius_unit`	string	Unit for radius (`"km"` or `"mi"`)	`"km"`, `"mi"`
`years_experience`	string/object	Years of experience range	`"5-10"`, `{"min": 5, "max": 10}`
`job_change_range_days`	integer	Recently changed jobs (within X days)	`90`, `180`
`keywords`	string/array/object	Keywords in profile	`"SaaS"`, `["AI", "Machine Learning"]`
`company_domains`	string/array	Company website domain(s)	`"microsoft.com"`, `["google.com", "apple.com"]`
`company_industry_keywords`	string/array	Keywords in company description	`"AI"`, `["SaaS", "Cloud"]`

Common Company Size Values

"1-10" - 1-10 employees
"11-50" - 11-50 employees
"51-200" - 51-200 employees
"201-500" - 201-500 employees
"501-1000" - 501-1000 employees
"1001-5000" - 1001-5000 employees
"5001-10000" - 5001-10000 employees
"10000+" - 10000+ employees

Common Seniority Levels

"Entry"
"Senior"
"Manager"
"Director"
"VP"
"C-Level"
"Owner"

For Company Search (`search_type: "COMPANY"`)

Filter	Type	Description	Example Values
`company_name`	string/array	Company name	`"Microsoft"`, `["Google", "Apple"]`
`location`	string/array	Geographic location	`"San Francisco, CA"`, `["New York", "Boston"]`
`industry`	string/array	Industry sector	`"Technology"`, `["Software", "SaaS"]`
`company_size`	string/array	Number of employees	`"51-200"`, `["51-200", "201-500"]`
`revenue`	string/array	Annual revenue range	`"$10M-$50M"`, `["$10M-$50M", "$50M-$100M"]`
`company_industry_keywords`	string/array	Keywords in company description	`"AI"`, `["SaaS", "Cloud"]`

Response (People)

{
  "success": true,
  "search_type": "PEOPLE",
  "total_count": 1247,
  "page": 1,
  "page_size": 25,
  "prospects": [
    {
      "id": 12345,
      "first_name": "John",
      "last_name": "Doe",
      "email": "john.doe@company.com",
      "phone_number": "+1234567890",
      "linkedin_profile_url": "https://linkedin.com/in/johndoe",
      "job_title": "CEO",
      "location": "San Francisco, CA",
      "headline": "CEO at Tech Company",
      "company": {
        "id": 678,
        "name": "Tech Company",
        "website_url": "https://techcompany.com",
        "linkedin_url": "https://linkedin.com/company/techcompany",
        "industry": "Technology",
        "location": "San Francisco, CA",
        "amount_of_employees": "51-200"
      }
    }
  ]
}

Response (Companies)

{
  "success": true,
  "search_type": "COMPANY",
  "total_count": 543,
  "page": 1,
  "page_size": 25,
  "companies": [
    {
      "id": 678,
      "name": "Tech Company",
      "website_url": "https://techcompany.com",
      "linkedin_url": "https://linkedin.com/company/techcompany",
      "logo_url": "https://logo.clearbit.com/techcompany.com",
      "industry": "Technology",
      "location": "San Francisco, CA",
      "amount_of_employees": "51-200",
      "revenue": "$10M-$50M"
    }
  ]
}

Error Responses

400 Bad Request

{
  "error": "search_type must be either 'PEOPLE' or 'COMPANY'"
}

403 Forbidden

{
  "success": false,
  "error": "search_limit",
  "message": "You have reached the maximum number of searches per month"
}

Example Usage

Example 1: Simple String Filters

curl -X POST "https://api.seleqt.ai/api/v1/public/prospects/search/" \
  -H "X-API-Key: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "search_type": "PEOPLE",
    "page": 1,
    "page_size": 25,
    "filters": {
      "job_title": "VP",
      "industry": "Technology",
      "company_size": "51-200"
    }
  }'

Example 2: Array Filters (Multiple Options)

curl -X POST "https://api.seleqt.ai/api/v1/public/prospects/search/" \
  -H "X-API-Key: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "search_type": "PEOPLE",
    "filters": {
      "job_title": ["CEO", "Founder", "Co-Founder"],
      "seniority": ["C-Level", "VP"],
      "department": ["Sales", "Marketing"],
      "prospect_location": ["San Francisco, CA, United States", "New York, NY, United States"],
      "company_size": ["51-200", "201-500"]
    }
  }'

Example 3: Include/Exclude Logic

curl -X POST "https://api.seleqt.ai/api/v1/public/prospects/search/" \
  -H "X-API-Key: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "search_type": "PEOPLE",
    "filters": {
      "job_title": {
        "must": ["VP", "Director"],
        "doesnt": ["Intern", "Associate"]
      },
      "keywords": {
        "must": ["SaaS", "B2B"],
        "doesnt": ["Retail"]
      }
    }
  }'

Example 4: Location with Radius

curl -X POST "https://api.seleqt.ai/api/v1/public/prospects/search/" \
  -H "X-API-Key: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "search_type": "PEOPLE",
    "filters": {
      "prospect_location": "San Francisco, CA, United States",
      "location_radius": 50,
      "location_radius_unit": "km"
    }
  }'

Example 5: Python SDK

import requests

# Simple search
response = requests.post(
    "https://api.seleqt.ai/api/v1/public/prospects/search/",
    headers={"X-API-Key": "<your-api-key>"},
    json={
        "search_type": "PEOPLE",
        "page": 1,
        "page_size": 50,
        "filters": {
            "job_title": "VP",
            "industry": "Technology",
            "company_size": "51-200"
        }
    }
)

data = response.json()
if data["success"]:
    prospects = data["prospects"]
    print(f"Found {data['total_count']} total prospects")
    for prospect in prospects:
        print(f"{prospect['first_name']} {prospect['last_name']} - {prospect['job_title']}")

# Advanced search with multiple filters
response = requests.post(
    "https://api.seleqt.ai/api/v1/public/prospects/search/",
    headers={"X-API-Key": "<your-api-key>"},
    json={
        "search_type": "PEOPLE",
        "filters": {
            "job_title": ["CEO", "Founder"],
            "seniority": ["C-Level"],
            "department": ["Sales", "Marketing"],
            "years_experience": {"min": 10, "max": 20},
            "prospect_location": ["United States"],
            "company_size": ["51-200", "201-500"]
        }
    }
)

Example 6: Company Search

curl -X POST "https://api.seleqt.ai/api/v1/public/prospects/search/" \
  -H "X-API-Key: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "search_type": "COMPANY",
    "filters": {
      "industry": "Technology",
      "company_size": "51-200",
      "location": "United States"
    }
  }'

Getting Started

API Reference

Public API

Webhooks

POST /api/v1/public/prospects/search/

Request Body

Parameters

For People Search (`search_type: "PEOPLE"`)

Common Company Size Values

Common Seniority Levels

For Company Search (`search_type: "COMPANY"`)

Response (People)

Response (Companies)

Error Responses

400 Bad Request

403 Forbidden

Example Usage

Example 1: Simple String Filters

Example 2: Array Filters (Multiple Options)

Example 3: Include/Exclude Logic

Example 4: Location with Radius

Example 5: Python SDK

Example 6: Company Search

​POST /api/v1/public/prospects/search/

​Request Body

​Parameters

​Filter Options

​For People Search (search_type: "PEOPLE")

​Common Company Size Values

​Common Seniority Levels

​For Company Search (search_type: "COMPANY")

​Response (People)

​Response (Companies)

​Error Responses

​400 Bad Request

​403 Forbidden

​Example Usage

​Example 1: Simple String Filters

​Example 2: Array Filters (Multiple Options)

​Example 3: Include/Exclude Logic

​Example 4: Location with Radius

​Example 5: Python SDK

​Example 6: Company Search

POST /api/v1/public/prospects/search/

Request Body

Parameters

Filter Options

For People Search (`search_type: "PEOPLE"`)

Common Company Size Values

Common Seniority Levels

For Company Search (`search_type: "COMPANY"`)

Response (People)

Response (Companies)

Error Responses

400 Bad Request

403 Forbidden

Example Usage

Example 1: Simple String Filters

Example 2: Array Filters (Multiple Options)

Example 3: Include/Exclude Logic

Example 4: Location with Radius

Example 5: Python SDK

Example 6: Company Search