Prospeo: Search Person

Search people by job title, department, seniority, company domain, industry, headcount, technology, and location for prospect lists.

Tool ID: prospeo_search_person

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(
  'prospeo_search_person',
  {
    "person_name": {
      "include": [
        "example"
      ],
      "exclude": [
        "example"
      ]
    },
    "person_name_or_job_title": "VP of Engineering",
    "person_job_title": {
      "include": [
        "example"
      ],
      "exclude": [
        "example"
      ],
      "match_only_exact_job_titles": true
    }
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute prospeo_search_person --input '{
  "person_name": {
    "include": [
      "example"
    ],
    "exclude": [
      "example"
    ]
  },
  "person_name_or_job_title": "VP of Engineering",
  "person_job_title": {
    "include": [
      "example"
    ],
    "exclude": [
      "example"
    ],
    "match_only_exact_job_titles": true
  }
}' --json

Example response

The static output schema lacks the details for a reliable example. Use deepline describe prospeo_search_person --json for the complete live contract.

Input reference

Search people with rich Prospeo filters. 0.55 Deepline credits per page of 25 results.

Name	Type	Required	Default	Details
`payload.person_name`	`object`	No	—	Filter by person name.
`payload.person_name_or_job_title`	`string`	No	—	Quick free-text search across person name and title.
`payload.person_job_title`	`object`	No	—	Filter by person job title with exact/contains/bool semantics.
`payload.person_department`	`object`	No	—	Filter by person department.
`payload.person_seniority`	`object`	No	—	Filter by person seniority level. Official Prospeo values are case-sensitive: Founder/Owner, C-Suite, Partner, Vice President, Head, Director, Manager, Senior, Entry, Intern. Common aliases like vp, VP, c_level, owner, founder, and lowercase values are accepted and normalized before calling Prospeo.
`payload.person_location_search`	`object`	No	—	Filter by person location.
`payload.person_contact_details`	`object`	No	—	Filter by available contact channels.
`payload.person_duplicate_control`	`record`	No	—	Duplicate-control settings export from dashboard.
`payload.max_person_per_company`	`integer`	No	—	—
`payload.person_year_of_experience`	`object`	No	—	Prospeo numeric range filter object.
`payload.person_time_in_current_role`	`object`	No	—	Prospeo numeric range filter object.
`payload.person_time_in_current_company`	`object`	No	—	Prospeo numeric range filter object.
`payload.company`	`object`	No	—	Filter by company names or websites.
`payload.company_location_search`	`object`	No	—	Filter by company HQ location.
`payload.company_headcount_range`	`array`	No	—	Filter by predefined employee count ranges.
`payload.company_headcount_custom`	`object`	No	—	Filter by custom employee count range.
`payload.company_industry`	`object`	No	—	Filter by company industry.
`payload.company_keywords`	`object`	No	—	Filter by keywords in company data.
`payload.company_attributes`	`object`	No	—	Filter by company characteristics.
`payload.company_naics`	`object`	No	—	Filter by NAICS codes.
`payload.company_sics`	`object`	No	—	Filter by SIC codes.
`payload.company_revenue`	`object`	No	—	Filter by revenue range.
`payload.company_type`	`"Private" \| "Public" \| "Non Profit" \| "Other"`	No	—	Allowed: `Private`, `Public`, `Non Profit`, `Other`.
`payload.company_funding`	`object`	No	—	—
`payload.company_technology`	`object`	No	—	Filter by technologies used by company.
`payload.company_founded`	`object`	No	—	Filter by founding year.
`payload.company_headcount_growth`	`object`	No	—	Filter by headcount growth.
`payload.company_job_posting_hiring_for`	`array`	No	—	Filter by current hiring roles.
`payload.company_job_posting_quantity`	`object`	No	—	Filter by number of open job postings.
`payload.company_headcount_by_department`	`array`	No	—	Filter by company department headcount.
`payload.company_email_provider`	`array`	No	—	Filter by email provider.
`payload.page`	`integer`	No	`1`	Page number (min 1). 25 results per page.

This input schema is too large for an inline display. Read the complete live contract with deepline describe prospeo_search_person --json.

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`record`	Yes	—	Provider response payload.
`result.meta`	`record`	No	—	Additional response metadata (status, paging).

Deepline cost

Pricing model: per_result (per result).
Estimated Deepline credits: 0.55 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