Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.seleqt.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
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

ParameterTypeRequiredDefaultDescription
search_typestringNoPEOPLEEither PEOPLE or COMPANY to specify what type of leads to search for
pageintegerNo1Page number for pagination
page_sizeintegerNo25Number of results per page (max 100)
filtersobjectNo{}Filter criteria (see below)

​
Filter Options

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

FilterTypeDescriptionExample Values
job_titlestring/arrayJob title(s) to search for"VP", ["CEO", "Founder"]
senioritystring/arraySeniority/management level"VP", ["Director", "C-Level", "VP"]
departmentstring/arrayDepartment/function"Sales", ["Sales", "Marketing"]
company_namestring/array/objectCompany name(s)"Microsoft", ["Google", "Apple"], {"must": ["Tech"], "doesnt": ["Corp"]}
company_sizestring/arrayCompany size range"51-200", ["51-200", "201-500"]
industrystring/arrayIndustry sector"Technology", ["Technology", "Software"]
prospect_locationstring/arrayGeographic location"San Francisco, CA, United States", ["New York", "Los Angeles"]
location_radiusintegerRadius for location search (in km or mi)25, 50
location_radius_unitstringUnit for radius ("km" or "mi")"km", "mi"
years_experiencestring/objectYears of experience range"5-10", {"min": 5, "max": 10}
job_change_range_daysintegerRecently changed jobs (within X days)90, 180
keywordsstring/array/objectKeywords in profile"SaaS", ["AI", "Machine Learning"]
company_domainsstring/arrayCompany website domain(s)"microsoft.com", ["google.com", "apple.com"]
company_industry_keywordsstring/arrayKeywords 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")

FilterTypeDescriptionExample Values
company_namestring/arrayCompany name"Microsoft", ["Google", "Apple"]
locationstring/arrayGeographic location"San Francisco, CA", ["New York", "Boston"]
industrystring/arrayIndustry sector"Technology", ["Software", "SaaS"]
company_sizestring/arrayNumber of employees"51-200", ["51-200", "201-500"]
revenuestring/arrayAnnual revenue range"$10M-$50M", ["$10M-$50M", "$50M-$100M"]
company_industry_keywordsstring/arrayKeywords 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"]
        }
    }
)

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