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

# Apollo: Search People

> Free people search by job title, seniority, location and company (domain, employee count, revenue, technology). Includes SDK V2 examples, schemas, and cost.

Free people search by job title, seniority, location and company (domain, employee count, revenue, technology).

> [!NOTE]
>
> Tool ID: `apollo_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(
  'apollo_search_people',
  {
    "page": 123,
    "per_page": 123,
    "person_titles": [
      "example"
    ]
  },
);

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

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute apollo_search_people --input '{
  "page": 123,
  "per_page": 123,
  "person_titles": [
    "example"
  ]
}' --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": {
    "total_entries": 123,
    "people": [
      {}
    ],
    "pagination": {}
  }
}
```

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

## Input reference

Prospect people from Apollo's global dataset using native people-search filters. This searches outside your Apollo CRM. exact billing depends on the selected Apollo people-search tool.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.page` | `integer` | No | — | Page number (1-500). |
| `payload.per_page` | `integer` | No | — | Results per page (1-100). |
| `payload.person_titles` | `array` | No | — | Job titles to match. |
| `payload.include_similar_titles` | `boolean` | No | `true` | Include similar titles for person\_titles matches. |
| `payload.person_seniorities` | `array` | No | — | Seniority filter values defined by Apollo. |
| `payload.person_locations` | `array` | No | — | Person locations. |
| `payload.organization_locations` | `array` | No | — | Organization HQ locations. |
| `payload.organization_num_employees_ranges` | `array` | No | — | Employee ranges accepted by the Apollo search contract, for example '51,200' or '201,500'. |
| `payload.q_organization_domains_list` | `array` | No | — | Organization domains to include. |
| `payload.contact_email_status` | `array` | No | — | Email status values (e.g., 'verified', 'guessed'). |
| `payload.organization_ids` | `array` | No | — | Apollo organization IDs to include. |
| `payload.q_keywords` | `string` | No | — | Keyword query across person and organization fields. |
| `payload.revenue_range` | `object` | No | — | Inclusive numeric range. |
| `payload.currently_using_any_of_technology_uids` | `array` | No | — | Organizations using ANY of these technology UIDs. |
| `payload.currently_using_all_of_technology_uids` | `array` | No | — | Organizations using ALL of these technology UIDs. |
| `payload.currently_not_using_any_of_technology_uids` | `array` | No | — | Exclude organizations using ANY of these technology UIDs. |
| `payload.q_organization_job_titles` | `array` | No | — | Organizations hiring for these job titles. |
| `payload.organization_job_locations` | `array` | No | — | Organizations hiring in these locations. |
| `payload.organization_num_jobs_range` | `object` | No | — | Inclusive integer range. |
| `payload.organization_job_posted_at_range` | `object` | No | — | Inclusive date range. |

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

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Prospect people from Apollo's global dataset using native people-search filters. This searches outside your Apollo CRM; exact billing depends on the selected Apollo people-search tool.",
    "properties": {
      "page": {
        "type": "integer",
        "description": "Page number (1-500)."
      },
      "per_page": {
        "type": "integer",
        "description": "Results per page (1-100)."
      },
      "person_titles": {
        "type": "array",
        "description": "Job titles to match.",
        "items": {
          "type": "string"
        }
      },
      "include_similar_titles": {
        "type": "boolean",
        "description": "Include similar titles for person_titles matches.",
        "default": true
      },
      "person_seniorities": {
        "type": "array",
        "description": "Seniority filter values defined by Apollo.",
        "items": {
          "type": "string",
          "description": "Apollo person seniority value.",
          "enum": [
            "owner",
            "founder",
            "c_suite",
            "partner",
            "vp",
            "head",
            "director",
            "manager",
            "senior",
            "entry",
            "intern"
          ]
        }
      },
      "person_locations": {
        "type": "array",
        "description": "Person locations.",
        "items": {
          "type": "string"
        }
      },
      "organization_locations": {
        "type": "array",
        "description": "Organization HQ locations.",
        "items": {
          "type": "string"
        }
      },
      "organization_num_employees_ranges": {
        "type": "array",
        "description": "Employee ranges accepted by the Apollo search contract, for example '51,200' or '201,500'.",
        "items": {
          "type": "string"
        }
      },
      "q_organization_domains_list": {
        "type": "array",
        "description": "Organization domains to include.",
        "items": {
          "type": "string"
        }
      },
      "contact_email_status": {
        "type": "array",
        "description": "Email status values (e.g., 'verified', 'guessed').",
        "items": {
          "type": "string"
        }
      },
      "organization_ids": {
        "type": "array",
        "description": "Apollo organization IDs to include.",
        "items": {
          "type": "string"
        }
      },
      "q_keywords": {
        "type": "string",
        "description": "Keyword query across person and organization fields."
      },
      "revenue_range": {
        "type": "object",
        "description": "Inclusive numeric range.",
        "properties": {
          "min": {
            "type": "number",
            "description": "Minimum numeric value."
          },
          "max": {
            "type": "number",
            "description": "Maximum numeric value."
          }
        },
        "additionalProperties": false
      },
      "currently_using_any_of_technology_uids": {
        "type": "array",
        "description": "Organizations using ANY of these technology UIDs.",
        "items": {
          "type": "string"
        }
      },
      "currently_using_all_of_technology_uids": {
        "type": "array",
        "description": "Organizations using ALL of these technology UIDs.",
        "items": {
          "type": "string"
        }
      },
      "currently_not_using_any_of_technology_uids": {
        "type": "array",
        "description": "Exclude organizations using ANY of these technology UIDs.",
        "items": {
          "type": "string"
        }
      },
      "q_organization_job_titles": {
        "type": "array",
        "description": "Organizations hiring for these job titles.",
        "items": {
          "type": "string"
        }
      },
      "organization_job_locations": {
        "type": "array",
        "description": "Organizations hiring in these locations.",
        "items": {
          "type": "string"
        }
      },
      "organization_num_jobs_range": {
        "type": "object",
        "description": "Inclusive integer range.",
        "properties": {
          "min": {
            "type": "integer",
            "description": "Minimum integer value."
          },
          "max": {
            "type": "integer",
            "description": "Maximum integer value."
          }
        },
        "additionalProperties": false
      },
      "organization_job_posted_at_range": {
        "type": "object",
        "description": "Inclusive date range.",
        "properties": {
          "min": {
            "type": "string",
            "description": "Minimum date/time (ISO 8601)."
          },
          "max": {
            "type": "string",
            "description": "Maximum date/time (ISO 8601)."
          }
        },
        "additionalProperties": false
      }
    },
    "required": [],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Apollo search people result. Deepline wraps Apollo payload under `data`, so access rows at `result.data.people` in tools output (or `&lt;column&gt;.data.people` in enrich columns). Important: last names can be obfuscated in search output. Before generating emails, enrich Apollo person IDs via `apollo_bulk_people_enrichment` with `details: [&#123; id &#125;]` to get full name fields.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Apollo native payload with top-level `&#123; total_entries, people, pagination &#125;` fields. |
| `result.data.total_entries` | `number` | No | — | Total number of matching people records. |
| `result.data.people` | `array` | No | — | — |
| `result.data.pagination` | `record` | No | — | — |
| `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": "Apollo search people result. Deepline wraps Apollo payload under `data`, so access rows at `result.data.people` in tools output (or `<column>.data.people` in enrich columns). Important: last names can be obfuscated in search output. Before generating emails, enrich Apollo person IDs via `apollo_bulk_people_enrichment` with `details: [{ id }]` to get full name fields.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Apollo native payload with top-level `{ total_entries, people, pagination }` fields.",
        "properties": {
          "total_entries": {
            "type": "number",
            "description": "Total number of matching people records."
          },
          "people": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": {}
            }
          },
          "pagination": {
            "type": "object",
            "additionalProperties": {}
          }
        },
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": {}
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

## Related documentation

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