ContactOut: Search People

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

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.

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

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.

{
  "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.

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.

Deepline cost

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

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation