SmartProspect: search contacts
smartprospect_search_contactsFind qualified leads by searching the SmartProspect database using filters like title, location, and company. Get a preview page with filter_id and scroll_id for paginated retrieval.
Instructions
Search the SmartProspect contact database with filters and return a preview page plus filter_id, total_count and scroll_id.
Safety — read-only: yes; may consume SmartProspect credits: no; creates or modifies remote state: no; can send email: no; destructive: no.
Endpoint: POST https://prospect-api.smartlead.ai/api/v1/search-email-leads/search-contacts.
Read-only. Running a search does not fetch or reveal credit-gated contacts and does not spend credits by itself.
limit is required and must be 1-500; every array filter accepts at most 2000 items.
Pass the returned scroll_id back in to page through results; keep the filter_id to fetch or retrieve contacts later.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | Cities (max 2000 items). | |
| name | No | Full names (max 2000 items). | |
| level | No | Seniority levels (max 2000 items). | |
| limit | Yes | Number of contacts to return (1-500). Required by Smartlead. | |
| state | No | States (max 2000 items). | |
| title | No | Job titles (max 2000 items). | |
| country | No | Countries (max 2000 items). | |
| lastName | No | Last names (max 2000 items). | |
| firstName | No | First names (max 2000 items). | |
| scroll_id | No | Scroll ID returned by a previous search, to fetch the next page. | |
| department | No | Departments (max 2000 items). | |
| companyName | No | Company names (max 2000 items). | |
| excludeTitle | No | Job titles to exclude (max 2000 items). | |
| includeTitle | No | Job titles to include (max 2000 items). | |
| companyDomain | No | Company domains (max 2000 items). | |
| companyKeyword | No | Company keywords (max 2000 items). | |
| companyRevenue | No | Company revenue ranges (max 2000 items). | |
| excludeCompany | No | Companies to exclude (max 2000 items). | |
| includeCompany | No | Companies to include (max 2000 items). | |
| companyIndustry | No | Industries (max 2000 items). | |
| titleExactMatch | No | Match job titles exactly. | |
| companyHeadCount | No | Company head count ranges (max 2000 items). | |
| companyExactMatch | No | Match company names exactly. | |
| companySubIndustry | No | Sub-industries (max 2000 items). | |
| excludeCompanyDomain | No | Company domains to exclude (max 2000 items). | |
| includeCompanyDomain | No | Company domains to include (max 2000 items). | |
| include_full_records | No | Return complete preview records including names and personal fields. Defaults to false for privacy; opt in explicitly when those fields are needed. | |
| companyDomainExactMatch | No | Match company domains exactly. | |
| dontDisplayOwnedContact | No | Exclude contacts you already own. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| data | Yes | ||
| error | No | ||
| warnings | Yes | ||
| operation | Yes | ||
| pagination | Yes | ||
| credit_spending | Yes | ||
| remote_mutation | Yes |