> ## 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.

# ContactOut: Search People

> Search people by job title, company, company domain, industry, location, seniority, and skills, returning LinkedIn profiles.

Search people by job title, company, company domain, industry, location, seniority, and skills, returning LinkedIn profiles.

> [!NOTE]
>
> Tool ID: `contactout_search_people`

## 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(
  'contactout_search_people',
  {
    "job_title": "VP of Engineering",
    "company": "Example Corp",
    "domain": "example.com"
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute contactout_search_people --input '{
  "job_title": "VP of Engineering",
  "company": "Example Corp",
  "domain": "example.com"
}' --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"]}}
{
  "data": {
    "profiles": [
      {
        "linkedin_url": "https://www.linkedin.com/in/jane-doe",
        "full_name": "Example",
        "headline": "example"
      }
    ]
  }
}
```

Use `deepline describe contactout_search_people --json` for the latest machine-readable contract.

## Input reference

Search ContactOut people profiles using legacy Deepline search filters while preserving the migration-time public contract. Billing is 1 ContactOut search credit per returned profile. ContactOut controls the page size and exposes no page-size parameter, so a call returns and bills a full page even when you need fewer results. narrow the filters to change who is returned, not how many. The number billed is echoed back as metadata.page\_size. Use the free contactout\_count\_people to size an audience before paying for a search.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.job_title` | `string` | No | — | Minimum length: 1. |
| `payload.company` | `string` | No | — | Minimum length: 1. |
| `payload.domain` | `string` | No | — | Minimum length: 1. |
| `payload.industry` | `string` | No | — | Minimum length: 1. |
| `payload.location` | `string` | No | — | Minimum length: 1. |
| `payload.seniority` | `string` | No | — | Minimum length: 1. |
| `payload.company_size` | `string` | No | — | Minimum length: 1. |
| `payload.name` | `string` | No | — | Minimum length: 1. |
| `payload.skills` | `string` | No | — | Minimum length: 1. |
| `payload.job_function` | `string` | No | — | Minimum length: 1. |
| `payload.years_of_experience` | `string` | No | — | Minimum length: 1. |
| `payload.data_types` | `array` | No | — | Minimum items: 1. |
| `payload.reveal_info` | `boolean` | No | `false` | Whether to reveal contact info (emails/phones) for each returned profile. This gates only the ADDITIONAL email/phone credits. It does NOT make the search free: search credits are billed per returned profile either way, so reveal\_info: false is not a discovery or count mode. Use contactout\_count\_people to size an audience for free. |
| `payload.page` | `integer` | No | `1` | Page number, starting at 1. ContactOut controls the page size and there is no page-size parameter, so you cannot request fewer results. Each page bills 1 search credit per profile it returns. The size of the page actually billed is returned as metadata.page\_size. Minimum: 1. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Search ContactOut people profiles using legacy Deepline search filters while preserving the migration-time public contract. Billing is 1 ContactOut search credit per returned profile. ContactOut controls the page size and exposes no page-size parameter, so a call returns and bills a full page even when you need fewer results; narrow the filters to change who is returned, not how many. The number billed is echoed back as metadata.page_size. Use the free contactout_count_people to size an audience before paying for a search.",
    "properties": {
      "job_title": {
        "type": "string",
        "minLength": 1
      },
      "company": {
        "type": "string",
        "minLength": 1
      },
      "domain": {
        "type": "string",
        "minLength": 1
      },
      "industry": {
        "type": "string",
        "minLength": 1
      },
      "location": {
        "type": "string",
        "minLength": 1
      },
      "seniority": {
        "type": "string",
        "minLength": 1
      },
      "company_size": {
        "type": "string",
        "minLength": 1
      },
      "name": {
        "type": "string",
        "minLength": 1
      },
      "skills": {
        "type": "string",
        "minLength": 1
      },
      "job_function": {
        "type": "string",
        "minLength": 1
      },
      "years_of_experience": {
        "type": "string",
        "minLength": 1
      },
      "data_types": {
        "type": "array",
        "minItems": 1,
        "items": {
          "type": "string",
          "enum": [
            "personal_email",
            "work_email",
            "phone"
          ]
        }
      },
      "reveal_info": {
        "type": "boolean",
        "description": "Whether to reveal contact info (emails/phones) for each returned profile. This gates only the ADDITIONAL email/phone credits. It does NOT make the search free: search credits are billed per returned profile either way, so reveal_info: false is not a discovery or count mode. Use contactout_count_people to size an audience for free.",
        "default": false
      },
      "page": {
        "type": "integer",
        "description": "Page number, starting at 1. ContactOut controls the page size and there is no page-size parameter, so you cannot request fewer results; each page bills 1 search credit per profile it returns. The size of the page actually billed is returned as metadata.page_size.",
        "default": 1,
        "minimum": 1
      }
    },
    "required": [],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.profiles` | `array` | Yes | — | — |
| `result.data.profiles[].linkedin_url` | `string` | No | — | — |
| `result.data.profiles[].full_name` | `string` | No | — | — |
| `result.data.profiles[].headline` | `string` | No | — | — |
| `result.data.profiles[].title` | `string` | No | — | — |
| `result.data.profiles[].location` | `string` | No | — | — |
| `result.data.profiles[].country` | `string` | No | — | — |
| `result.data.profiles[].industry` | `string` | No | — | — |
| `result.data.profiles[].seniority` | `string` | No | — | — |
| `result.data.profiles[].job_function` | `string` | No | — | — |
| `result.data.profiles[].followers` | `number` | No | — | — |
| `result.data.profiles[].updated_at` | `string` | No | — | — |
| `result.data.profiles[].profile_picture_url` | `string` | No | — | — |
| `result.data.profiles[].summary` | `string` | No | — | — |
| `result.data.profiles[].email` | `array` | No | — | — |
| `result.data.profiles[].work_email` | `array` | No | — | — |
| `result.data.profiles[].personal_email` | `array` | No | — | — |
| `result.data.profiles[].phone` | `array` | No | — | — |
| `result.data.profiles[].company` | `object` | No | — | — |
| `result.data.profiles[].company.name` | `string` | No | — | — |
| `result.data.profiles[].company.domain` | `string` | No | — | — |
| `result.data.profiles[].company.email_domain` | `string` | No | — | — |
| `result.data.profiles[].company.website` | `string` | No | — | — |
| `result.data.profiles[].company.logo_url` | `string` | No | — | — |
| `result.data.profiles[].company.type` | `string` | No | — | — |
| `result.data.profiles[].company.size` | `number \| string` | No | — | — |
| `result.data.profiles[].company.industry` | `string` | No | — | — |
| `result.data.profiles[].company.founded_at` | `number \| string` | No | — | — |
| `result.data.profiles[].company.headquarter` | `string` | No | — | — |
| `result.data.profiles[].company.locations` | `array` | No | — | — |
| `result.data.profiles[].company.revenue` | `number \| string \| null` | No | — | — |
| `result.data.profiles[].company.specialties` | `array` | No | — | — |
| `result.data.profiles[].company.followers` | `number` | No | — | — |
| `result.data.profiles[].company.employees` | `number` | No | — | — |
| `result.data.profiles[].company.funding` | `object` | No | — | — |
| `result.data.profiles[].company.funding.total_funding_usd` | `number` | No | — | — |
| `result.data.profiles[].company.funding.funding_status` | `string` | No | — | — |
| `result.data.profiles[].company.funding.latest_date` | `string` | No | — | — |
| `result.data.profiles[].company.funding.number_of_funding_rounds` | `number` | No | — | — |
| `result.data.profiles[].company.funding.rounds` | `array` | No | — | — |
| `result.data.profiles[].experience` | `array` | No | — | — |
| `result.data.profiles[].education` | `array` | No | — | — |
| `result.data.profiles[].skills` | `array` | No | — | — |
| `result.data.profiles[].contact_availability` | `object` | No | — | — |
| `result.data.profiles[].contact_availability.personal_email` | `boolean` | No | — | — |
| `result.data.profiles[].contact_availability.work_email` | `boolean` | No | — | — |
| `result.data.profiles[].contact_availability.phone` | `boolean` | No | — | — |
| `result.data.profiles[].work_email_status` | `record` | No | — | — |
| `result.data.metadata` | `object` | No | — | — |

The table shows the first 50 fields. Expand the raw schema below for every field.

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Provider response payload.",
        "properties": {
          "profiles": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "linkedin_url": {
                  "type": "string"
                },
                "full_name": {
                  "type": "string"
                },
                "headline": {
                  "type": "string"
                },
                "title": {
                  "type": "string"
                },
                "location": {
                  "type": "string"
                },
                "country": {
                  "type": "string"
                },
                "industry": {
                  "type": "string"
                },
                "seniority": {
                  "type": "string"
                },
                "job_function": {
                  "type": "string"
                },
                "followers": {
                  "type": "number"
                },
                "updated_at": {
                  "type": "string"
                },
                "profile_picture_url": {
                  "type": "string"
                },
                "summary": {
                  "type": "string"
                },
                "email": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "work_email": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "personal_email": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "phone": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "company": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string"
                    },
                    "domain": {
                      "type": "string"
                    },
                    "email_domain": {
                      "type": "string"
                    },
                    "website": {
                      "type": "string"
                    },
                    "logo_url": {
                      "type": "string"
                    },
                    "type": {
                      "type": "string"
                    },
                    "size": {
                      "type": [
                        "number",
                        "string"
                      ]
                    },
                    "industry": {
                      "type": "string"
                    },
                    "founded_at": {
                      "type": [
                        "number",
                        "string"
                      ]
                    },
                    "headquarter": {
                      "type": "string"
                    },
                    "locations": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "revenue": {
                      "type": [
                        "number",
                        "string",
                        "null"
                      ]
                    },
                    "specialties": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "followers": {
                      "type": "number"
                    },
                    "employees": {
                      "type": "number"
                    },
                    "funding": {
                      "type": "object",
                      "properties": {
                        "total_funding_usd": {
                          "type": "number"
                        },
                        "funding_status": {
                          "type": "string"
                        },
                        "latest_date": {
                          "type": "string"
                        },
                        "number_of_funding_rounds": {
                          "type": "number"
                        },
                        "rounds": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "additionalProperties": true
                          }
                        }
                      },
                      "additionalProperties": true
                    }
                  },
                  "additionalProperties": true
                },
                "experience": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "additionalProperties": true
                  }
                },
                "education": {
                  "type": "array",
                  "items": {}
                },
                "skills": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "contact_availability": {
                  "type": "object",
                  "properties": {
                    "personal_email": {
                      "type": "boolean"
                    },
                    "work_email": {
                      "type": "boolean"
                    },
                    "phone": {
                      "type": "boolean"
                    }
                  },
                  "additionalProperties": true
                },
                "work_email_status": {
                  "type": "object",
                  "additionalProperties": true
                }
              },
              "additionalProperties": true
            }
          },
          "metadata": {
            "type": "object",
            "properties": {
              "page": {
                "type": "number"
              },
              "page_size": {
                "type": "number"
              },
              "total_results": {
                "type": "number"
              }
            },
            "additionalProperties": true
          }
        },
        "required": [
          "profiles"
        ],
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `per_result` (per result).
* Estimated Deepline credits: `1.4` per pricing unit.

## Related documentation

* [ContactOut provider guide](https://deepline.com/docs/providers/contactout/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.