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

# Prospeo: Search Person

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

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

> [!NOTE]
>
> 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.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
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

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
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. |

> [!NOTE]
>
> 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). |

<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.",
        "additionalProperties": {}
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": {}
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

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

## Related documentation

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