> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Lusha: Search Contacts
> Prospect for contacts by department, seniority, company size, industry, job title, location, and technologies. Includes SDK V2 examples, schemas, and cost.
Prospect for contacts by department, seniority, company size, industry, job title, location, and technologies.
> [!NOTE]
>
> Tool ID: `lusha_search_contacts`
## Run this action
Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.
```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';
const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
'lusha_search_contacts',
{
"filters": {
"contacts": {
"include": {
"departments": [
"example"
],
"seniority": [
123
],
"existing_data_points": [
"example"
]
},
"exclude": {
"departments": [
"example"
],
"seniority": [
123
],
"existing_data_points": [
"example"
]
}
},
"companies": {
"include": {
"names": [
"Example"
],
"locations": [
{}
],
"technologies": [
"example"
]
},
"exclude": {
"names": [
"Example"
],
"locations": [
{}
],
"technologies": [
"example"
]
}
}
}
},
);
console.log(result.toolResponse.raw);
```
### CLI
```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute lusha_search_contacts --input '{
"filters": {
"contacts": {
"include": {
"departments": [
"example"
],
"seniority": [
123
],
"existing_data_points": [
"example"
]
},
"exclude": {
"departments": [
"example"
],
"seniority": [
123
],
"existing_data_points": [
"example"
]
}
},
"companies": {
"include": {
"names": [
"Example"
],
"locations": [
{}
],
"technologies": [
"example"
]
},
"exclude": {
"names": [
"Example"
],
"locations": [
{}
],
"technologies": [
"example"
]
}
}
}
}' --json
```
## Example response
The SDK returns this shape at `result.toolResponse.raw`. The example values illustrate the response.
```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
"requestId": "request_123",
"currentPage": 123,
"pageLength": 123,
"totalResults": 123,
"contacts": [
{
"personId": "person_123",
"firstName": "Jane",
"lastName": "Doe",
"title": "VP of Engineering",
"department": "example",
"companyName": "Example Corp",
"companyDomain": "example.com",
"location": "example",
"linkedinUrl": "https://www.linkedin.com/in/jane-doe"
}
]
}
```
Use `deepline describe lusha_search_contacts --json` for the latest machine-readable contract.
## Input reference
| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.includePartialContact` | `boolean` | No | — | Include contacts with partial information. Defaults to true upstream. |
| `payload.excludeDnc` | `boolean` | No | — | Exclude contacts whose phone numbers are all marked Do Not Call. |
| `payload.pages` | `object` | No | — | — |
| `payload.filters` | `object` | Yes | — | Current Lusha prospecting search contract uses nested contact/company filters. |
Show raw input schema
### Input JSON Schema
```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
"type": "object",
"properties": {
"includePartialContact": {
"type": "boolean",
"description": "Include contacts with partial information. Defaults to true upstream."
},
"excludeDnc": {
"type": "boolean",
"description": "Exclude contacts whose phone numbers are all marked Do Not Call."
},
"pages": {
"type": "object",
"properties": {
"page": {
"type": "integer",
"description": "Zero-based page number for pagination.",
"minimum": 0
},
"size": {
"type": "integer",
"description": "Results per page (10-100).",
"minimum": 10,
"maximum": 100
}
},
"additionalProperties": false
},
"filters": {
"type": "object",
"description": "Current Lusha prospecting search contract uses nested contact/company filters.",
"properties": {
"contacts": {
"type": "object",
"properties": {
"include": {
"type": "object",
"properties": {
"departments": {
"type": "array",
"items": {
"type": "string"
}
},
"seniority": {
"type": "array",
"items": {
"type": "integer"
}
},
"existing_data_points": {
"type": "array",
"items": {
"type": "string"
}
},
"locations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"continent": {
"type": "string"
},
"country": {
"type": "string"
},
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"country_grouping": {
"type": "string"
}
},
"additionalProperties": false
}
},
"signals": {
"type": "object",
"properties": {
"names": {
"type": "array",
"items": {
"type": "string"
}
},
"startDate": {
"type": "string",
"format": "date"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"exclude": {
"type": "object",
"properties": {
"departments": {
"type": "array",
"items": {
"type": "string"
}
},
"seniority": {
"type": "array",
"items": {
"type": "integer"
}
},
"existing_data_points": {
"type": "array",
"items": {
"type": "string"
}
},
"locations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"continent": {
"type": "string"
},
"country": {
"type": "string"
},
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"country_grouping": {
"type": "string"
}
},
"additionalProperties": false
}
},
"signals": {
"type": "object",
"properties": {
"names": {
"type": "array",
"items": {
"type": "string"
}
},
"startDate": {
"type": "string",
"format": "date"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"companies": {
"type": "object",
"properties": {
"include": {
"type": "object",
"properties": {
"names": {
"type": "array",
"items": {
"type": "string"
}
},
"locations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"continent": {
"type": "string"
},
"country": {
"type": "string"
},
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"country_grouping": {
"type": "string"
}
},
"additionalProperties": false
}
},
"technologies": {
"type": "array",
"items": {
"type": "string"
}
},
"mainIndustriesIds": {
"type": "array",
"items": {
"type": "integer"
}
},
"subIndustriesIds": {
"type": "array",
"items": {
"type": "integer"
}
},
"intentTopics": {
"type": "array",
"items": {
"type": "string"
}
},
"sizes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"min": {
"type": "number"
},
"max": {
"type": "number"
}
},
"additionalProperties": false
}
},
"revenues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"min": {
"type": "number"
},
"max": {
"type": "number"
}
},
"additionalProperties": false
}
},
"sicCodes": {
"type": "array",
"items": {
"type": "string"
}
},
"naicsCodes": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"exclude": {
"type": "object",
"properties": {
"names": {
"type": "array",
"items": {
"type": "string"
}
},
"locations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"continent": {
"type": "string"
},
"country": {
"type": "string"
},
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"country_grouping": {
"type": "string"
}
},
"additionalProperties": false
}
},
"technologies": {
"type": "array",
"items": {
"type": "string"
}
},
"mainIndustriesIds": {
"type": "array",
"items": {
"type": "integer"
}
},
"subIndustriesIds": {
"type": "array",
"items": {
"type": "integer"
}
},
"intentTopics": {
"type": "array",
"items": {
"type": "string"
}
},
"sizes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"min": {
"type": "number"
},
"max": {
"type": "number"
}
},
"additionalProperties": false
}
},
"revenues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"min": {
"type": "number"
},
"max": {
"type": "number"
}
},
"additionalProperties": false
}
},
"sicCodes": {
"type": "array",
"items": {
"type": "string"
}
},
"naicsCodes": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"required": [
"filters"
],
"additionalProperties": false
}
```
## Output reference
| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.requestId` | `string` | Yes | — | — |
| `result.currentPage` | `integer` | Yes | — | — |
| `result.pageLength` | `integer` | Yes | — | — |
| `result.totalResults` | `integer` | Yes | — | — |
| `result.contacts` | `array` | Yes | — | — |
| `result.contacts[].personId` | `string` | Yes | — | — |
| `result.contacts[].firstName` | `string` | Yes | — | — |
| `result.contacts[].lastName` | `string` | Yes | — | — |
| `result.contacts[].title` | `string` | Yes | — | — |
| `result.contacts[].department` | `string` | Yes | — | — |
| `result.contacts[].companyName` | `string` | Yes | — | — |
| `result.contacts[].companyDomain` | `string` | Yes | — | — |
| `result.contacts[].location` | `string` | Yes | — | — |
| `result.contacts[].linkedinUrl` | `string` | Yes | — | — |
Show raw output schema
### Output JSON Schema
```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
"type": "object",
"properties": {
"requestId": {
"type": "string"
},
"currentPage": {
"type": "integer"
},
"pageLength": {
"type": "integer"
},
"totalResults": {
"type": "integer"
},
"contacts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"personId": {
"type": "string"
},
"firstName": {
"type": "string"
},
"lastName": {
"type": "string"
},
"title": {
"type": "string"
},
"department": {
"type": "string"
},
"companyName": {
"type": "string"
},
"companyDomain": {
"type": "string"
},
"location": {
"type": "string"
},
"linkedinUrl": {
"type": "string"
}
},
"required": [
"personId",
"firstName",
"lastName",
"title",
"department",
"companyName",
"companyDomain",
"location",
"linkedinUrl"
],
"additionalProperties": true
}
}
},
"required": [
"requestId",
"currentPage",
"pageLength",
"totalResults",
"contacts"
],
"additionalProperties": true
}
```
## Deepline cost
* Pricing model: `per_result` (per result).
* Estimated Deepline credits: `1.49` per pricing unit.
## Related documentation
* [Lusha provider guide](https://deepline.com/docs/providers/lusha/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.