Fetch-prospectsEXPLORIUM_MCP_FETCH_PROSPECTS
Searches for prospects (employees) using detailed filter criteria. Supports combining multiple filters in a single request for optimal performance.
**Use Cases:**
Finding people in specific roles at companies:
- "Who is the CTO at Google?"
- "Find engineers at Microsoft"
- "Show me sales directors at Apple"
**Data Characteristics:**
- Provides verified, structured professional data
- Returns prospects with detailed role information
**Filter Types:**
**Enum-Based Filters** (use values directly from the lists below):
- `job_level`: List[JobLevel] - Seniority level of the job
- Available values: "c-suite", "manager", "owner", "senior non-managerial", "partner", "freelancer",
"junior", "director", "board member", "founder", "president", "senior manager", "advisor",
"non-managerial", "vice president"
- `job_department`: List[JobDepartment] - Department or function in the organization
- Available values: "administration", "healthcare", "partnerships", "c-suite", "design",
"human resources", "engineering", "education", "strategy", "product", "sales", "r&d", "retail",
"customer success", "security", "public service", "creative", "it", "support", "marketing",
"trade", "legal", "operations", "real estate", "procurement", "data", "manufacturing",
"logistics", "finance"
- `company_size`: List[NumberOfEmployeesRange] - Employee count range
- Available values: "1-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10001+"
- `company_revenue`: List[CompanyRevenue] - Revenue range in USD
- Available values: "0-500K", "500K-1M", "1M-5M", "5M-10M", "10M-25M", "25M-75M",
"75M-200M", "200M-500M", "500M-1B", "1B-10B", "10B-100B", "100B-1T", "1T-10T", "10T+"
- `total_experience_months`: RangeInt - Experience in months (e.g., {"gte": 12, "lte": 120})
- `current_role_months`: RangeInt - Months in current role (e.g., {"gte": 6, "lte": 24})
- `company_age`: List[CompanyAgeRange] - Years since company founding
- Available values: "0-3", "3-6", "6-10", "10-20", "20+"
- `company_number_of_locations`: List[NumberOfLocations] - Number of office locations the company operates
- Available values: "0-1", "2-5", "6-20", "21-50", "51-100", "101-1000", "1001+"
**Boolean Filters** (true/false/null):
- `has_email`: literal true or null - Filter to include only prospects with verified email addresses
- `has_phone_number`: literal true or null - Filter to include only prospects with available phone numbers
- `has_website`: boolean or null - Set to true for prospects from companies with websites, false for prospects from companies without websites, or null to include all
- `is_public_company`: boolean or null - Set to true for prospects from publicly traded companies (with stock tickers), false for private companies, or null to include all
**Autocomplete-Required Filters** (standardized values MUST be obtained from autocomplete tool FIRST):
- `linkedin_category`: LinkedIn industry categories - REQUIRES autocomplete
- `job_title`: Job titles - REQUIRES autocomplete
- `interests`: Professional interests - REQUIRES autocomplete
- `skills`: Professional skills - REQUIRES autocomplete
- `naics_category`: NAICS industry codes - REQUIRES autocomplete
- `business_id`: Business IDs - REQUIRES match-business or fetch-businesses
**Direct-Use Filters** (use standard codes directly, no autocomplete needed):
- `country_code`: ISO Alpha-2 country codes (e.g., "US", "IL")
- `company_country_code`: ISO Alpha-2 country codes (e.g., "US", "IL")
- `region_country_code`: ISO 3166-2 region codes (e.g., "US-NY", "IL-TA")
- `company_region_country_code`: ISO 3166-2 region codes (e.g., "US-NY", "IL-TA")
**Technical Constraints:**
- `linkedin_category` and `naics_category` are mutually exclusive
- `region_country_code` and `country_code` are mutually exclusive
- `company_region_country_code` and `company_country_code` are mutually exclusive
- **CRITICAL:** Search requests using linkedin_category, job_title, interests, skills, naics_category, or business_id filters will fail without standardized values obtained first from their respective tools
**Returns:** Prospect records including prospect IDs (usable with enrich-prospects or fetch-prospects-events)
**Performance Note:** All applicable filters can be combined in a single request