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

# LeadMagic: People Search

> Search for people by company, title, role, seniority and company filters. Returns profiles, not emails or phone numbers.

Search for people by company, title, role, seniority and company filters.

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

## 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(
  'leadmagic_people_search',
  {
    "company_domain": "example.com",
    "company_name": "Example Corp",
    "linkedin_url": "https://www.linkedin.com/in/jane-doe"
  },
);

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

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline run leadmagic_people_search --input '{
  "company_domain": "example.com",
  "company_name": "Example Corp",
  "linkedin_url": "https://www.linkedin.com/in/jane-doe"
}'
```

## 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": {
    "message": "Example message",
    "credit_preview": {},
    "people": [
      {
        "contact_linkedin_url": "https://www.linkedin.com/in/jane-doe",
        "contact_linkedin_username": "https://www.linkedin.com/in/jane-doe",
        "contact_first_name": "Example"
      }
    ]
  }
}
```

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

## Input reference

Find professional profiles by company, title, role, seniority, and recorded profile attributes. Search never returns email addresses or phone numbers. request Email Finder or Mobile Finder separately for the people you choose.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.company_domain` | `string` | No | — | — |
| `payload.company_name` | `string` | No | — | — |
| `payload.linkedin_url` | `string` | No | — | B2B company profile URL or slug. |
| `payload.company_filters` | `object` | No | — | Criteria-based company set. Supports the full Company Search filter family. |
| `payload.people_filters` | `object` | No | — | People-level filters for names, title/function/level, geography, profile URLs, headline/about-me/industry, languages, seniority, connection count, and channel availability. Canonical keys use the contact\_\* prefix (e.g. contact\_linkedin\_about\_me). bare aliases such as about\_me, headline, industry, job\_function, and city are accepted. contact\_job\_function accepts short chips (Sales, Marketing, Finance, …) or full standard labels (Sales & Business Development, …). matching is exact after chip→label See the live schema for the complete constraint. |
| `payload.title` | `string` | No | — | — |
| `payload.job_title` | `string` | No | — | — |
| `payload.titles` | `array` | No | — | Maximum items: 12. |
| `payload.roles` | `array` | No | — | Maximum items: 12. |
| `payload.query` | `string` | No | — | Free-text people/title query. |
| `payload.include_company` | `boolean` | No | `true` | — |
| `payload.confirm_credit_charge` | `boolean` | No | `false` | Accepted for backwards compatibility. does not bypass RPS/unmetered unlock restrictions. |
| `payload.limit` | `integer` | No | `25` | Offset requests allow up to 10000 rows. cursor-based pages are capped at 50. Minimum: 1. Maximum: 100. |
| `payload.cursor` | `string` | No | — | Opaque signed next\_cursor from the previous page. Send unchanged with the same filters, a limit no greater than 50, and offset 0. |
| `payload.offset` | `integer` | No | `0` | Legacy offset pagination. prefer cursor. Unstable ordering, uncached. Restart at offset 0 to obtain a cursor. Minimum: 0. |

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

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Find professional profiles by company, title, role, seniority, and recorded profile attributes. Search never returns email addresses or phone numbers; request Email Finder or Mobile Finder separately for the people you choose.",
    "properties": {
      "company_domain": {
        "type": "string"
      },
      "company_name": {
        "type": "string"
      },
      "linkedin_url": {
        "type": "string",
        "description": "B2B company profile URL or slug."
      },
      "company_filters": {
        "type": "object",
        "description": "Criteria-based company set. Supports the full Company Search filter family.",
        "additionalProperties": true
      },
      "people_filters": {
        "type": "object",
        "description": "People-level filters for names, title/function/level, geography, profile URLs, headline/about-me/industry, languages, seniority, connection count, and channel availability. Canonical keys use the contact_* prefix (e.g. contact_linkedin_about_me); bare aliases such as about_me, headline, industry, job_function, and city are accepted. contact_job_function accepts short chips (Sales, Marketing, Finance, …) or full standard labels (Sales & Business Development, …); matching is exact after chip→label expansion and response rows always return the standard label. Multiple values in one array are OR'd; different people_filters keys in one request are AND'd. Keys the search cannot honor are echoed in interpreted_search.ignored_people_filters rather than silently dropped.",
        "additionalProperties": true
      },
      "title": {
        "type": "string"
      },
      "job_title": {
        "type": "string"
      },
      "titles": {
        "type": "array",
        "maxItems": 12,
        "items": {
          "type": "string"
        }
      },
      "roles": {
        "type": "array",
        "maxItems": 12,
        "items": {
          "type": "string"
        }
      },
      "query": {
        "type": "string",
        "description": "Free-text people/title query."
      },
      "include_company": {
        "type": "boolean",
        "default": true
      },
      "confirm_credit_charge": {
        "type": "boolean",
        "description": "Accepted for backwards compatibility; does not bypass RPS/unmetered unlock restrictions.",
        "default": false
      },
      "limit": {
        "type": "integer",
        "description": "Offset requests allow up to 10000 rows; cursor-based pages are capped at 50.",
        "default": 25,
        "minimum": 1,
        "maximum": 100
      },
      "cursor": {
        "type": "string",
        "description": "Opaque signed next_cursor from the previous page. Send unchanged with the same filters, a limit no greater than 50, and offset 0."
      },
      "offset": {
        "type": "integer",
        "description": "Legacy offset pagination; prefer cursor. Unstable ordering, uncached. Restart at offset 0 to obtain a cursor.",
        "default": 0,
        "minimum": 0
      }
    },
    "required": [],
    "additionalProperties": true
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.message` | `string` | No | — | — |
| `result.data.credit_preview` | `record` | No | — | — |
| `result.data.people` | `array` | No | — | — |
| `result.data.people[].contact_linkedin_url` | `string \| null` | No | — | — |
| `result.data.people[].contact_linkedin_username` | `string \| null` | No | — | — |
| `result.data.people[].contact_first_name` | `string \| null` | No | — | — |
| `result.data.people[].contact_last_name` | `string \| null` | No | — | — |
| `result.data.people[].contact_full_name` | `string \| null` | No | — | — |
| `result.data.people[].contact_linkedin_headline` | `string \| null` | No | — | — |
| `result.data.people[].contact_linkedin_industry` | `string \| null` | No | — | — |
| `result.data.people[].contact_linkedin_about_me` | `string \| null` | No | — | — |
| `result.data.people[].contact_city` | `string \| null` | No | — | — |
| `result.data.people[].contact_state` | `string \| null` | No | — | — |
| `result.data.people[].contact_state_code` | `string \| null` | No | — | — |
| `result.data.people[].contact_country` | `string \| null` | No | — | — |
| `result.data.people[].contact_country_code` | `string \| null` | No | — | — |
| `result.data.people[].contact_region` | `string \| null` | No | — | — |
| `result.data.people[].contact_continent` | `string \| null` | No | — | — |
| `result.data.people[].contact_job_title` | `string \| null` | No | — | — |
| `result.data.people[].contact_job_function` | `string \| null` | No | — | Standard department label for the person's current role (e.g. Sales & Business Development). Filter requests may use short chips such as Sales. responses always return this standard label. |
| `result.data.people[].contact_job_level` | `string \| null` | No | — | — |
| `result.data.people[].contact_job_description` | `string \| null` | No | — | — |
| `result.data.people[].contact_job_start_date` | `string \| null` | No | — | — |
| `result.data.people[].contact_job_count` | `integer \| null` | No | — | — |
| `result.data.people[].contact_persona` | `string \| null` | No | — | — |
| `result.data.people[].contact_job_city` | `string \| null` | No | — | — |
| `result.data.people[].contact_job_country` | `string \| null` | No | — | — |
| `result.data.people[].contact_job_country_code` | `string \| null` | No | — | — |
| `result.data.people[].contact_job_region` | `string \| null` | No | — | — |
| `result.data.people[].contact_job_continent` | `string \| null` | No | — | — |
| `result.data.people[].contact_job_state` | `string \| null` | No | — | — |
| `result.data.people[].contact_job_state_code` | `string \| null` | No | — | — |
| `result.data.people[].contact_company_name` | `string \| null` | No | — | — |
| `result.data.people[].company_domain` | `string \| null` | No | — | — |
| `result.data.people[].contact_education` | `string \| null` | No | — | — |
| `result.data.people[].contact_skills` | `string \| null` | No | — | — |
| `result.data.people[].contact_certifications` | `string \| null` | No | — | — |
| `result.data.people[].contact_languages` | `string \| null` | No | — | — |
| `result.data.people[].contact_websites` | `string \| null` | No | — | — |
| `result.data.people[].seniority_score` | `integer \| null` | No | — | — |
| `result.data.people[].has_email` | `boolean` | No | — | — |
| `result.data.people[].has_mobile_phone` | `boolean` | No | — | — |
| `result.data.people[].has_phone` | `boolean` | No | — | — |
| `result.data.people[].is_cio` | `boolean \| null` | No | — | — |
| `result.data.people[].is_it_leader` | `boolean \| null` | No | — | — |
| `result.data.people[].is_security` | `boolean \| null` | No | — | — |
| `result.data.people[].is_revops` | `boolean \| null` | No | — | — |
| `result.data.people[].is_recruiting` | `boolean \| null` | No | — | — |
| `result.data.people[].is_engineering` | `boolean \| null` | 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": {
          "message": {
            "type": "string"
          },
          "credit_preview": {
            "type": "object",
            "additionalProperties": true
          },
          "people": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "contact_linkedin_url": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "contact_linkedin_username": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "contact_first_name": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "contact_last_name": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "contact_full_name": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "contact_linkedin_headline": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "contact_linkedin_industry": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "contact_linkedin_about_me": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "contact_city": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "contact_state": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "contact_state_code": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "contact_country": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "contact_country_code": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "contact_region": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "contact_continent": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "contact_job_title": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "contact_job_function": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Standard department label for the person's current role (e.g. Sales & Business Development). Filter requests may use short chips such as Sales; responses always return this standard label."
                },
                "contact_job_level": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "contact_job_description": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "contact_job_start_date": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "contact_job_count": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "contact_persona": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "contact_job_city": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "contact_job_country": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "contact_job_country_code": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "contact_job_region": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "contact_job_continent": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "contact_job_state": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "contact_job_state_code": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "contact_company_name": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "company_domain": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "contact_education": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "contact_skills": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "contact_certifications": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "contact_languages": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "contact_websites": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "seniority_score": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "has_email": {
                  "type": "boolean"
                },
                "has_mobile_phone": {
                  "type": "boolean"
                },
                "has_phone": {
                  "type": "boolean"
                },
                "is_cio": {
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "is_it_leader": {
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "is_security": {
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "is_revops": {
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "is_recruiting": {
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "is_engineering": {
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "is_sales": {
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "is_marketing": {
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "is_operations": {
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "contactability_score": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "profile_completeness_score": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "job_observation_count": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "distinct_company_count": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "followers": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "company": {
                  "type": [
                    "object",
                    "null"
                  ],
                  "additionalProperties": true
                },
                "domain_intel": {
                  "type": [
                    "object",
                    "null"
                  ],
                  "additionalProperties": true
                },
                "unlock": {
                  "type": [
                    "object",
                    "null"
                  ],
                  "additionalProperties": true
                }
              },
              "additionalProperties": true
            }
          },
          "companies": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "count": {
            "type": "integer"
          },
          "returned_count": {
            "type": "integer"
          },
          "limit_applied": {
            "type": "integer"
          },
          "offset": {
            "type": "integer"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Opaque signed token for the next page, or null on the last page. Send back as cursor with offset 0. Cursor pagination is stable and cached."
          },
          "metadata": {
            "type": "object",
            "properties": {
              "pagination": {
                "type": "string",
                "description": "snapshot/cursor for cursor/first-page responses; offset for legacy offset responses.",
                "enum": [
                  "snapshot",
                  "cursor",
                  "offset"
                ]
              }
            },
            "additionalProperties": true
          },
          "ignored_filters": {
            "type": "array",
            "description": "Qualified keys of selected criteria that were not applied.",
            "items": {
              "type": "string"
            }
          },
          "warnings": {
            "type": "array",
            "description": "Explanations of unavailable or unapplied criteria.",
            "items": {
              "type": "string"
            }
          }
        },
        "additionalProperties": true
      },
      "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: `0.34` per pricing unit.

## Related documentation

* [Connect integrations](https://deepline.com/docs/integrations.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.