> ## 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: Inputs, Cost & CLI Example
> Previewing Apollo people discovery without spending Apollo credits. Includes inputs, outputs, pricing notes, Deepline CLI examples, and GTM automation guidance.
## Run in Enrichment Spreadsheet
Use this function as a column step in `deepline enrich`.
```bash theme={null}
deepline enrich --input leads.csv --output leads.enriched.csv --with 'result=apollo_search_people:{}' --json
```
Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
## Input Schema
| Name | Type | Required | Default | Description |
| ---------------------------------------------------- | --------- | -------- | ------- | ------------------------------------------------------------------------------------------ |
| `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. |
Show raw input schema
### Input JSON Schema
```json theme={null}
{
"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
}
```
## Output Schema
| Name | Type | Required | Default | Description |
| ------------- | -------- | -------- | ------- | ---------------------------------------------------------------------------------------------- |
| `result.data` | `object` | Yes | | Apollo native payload with top-level `{ total_entries, people, pagination }` fields. |
| `result.meta` | `record` | No | | Additional response metadata (status, paging). |
Show raw output schema
### Output JSON Schema
```json theme={null}
{
"type": "object",
"description": "Apollo search people result. Deepline wraps Apollo payload under `data`, so access rows at `result.data.people` in tools output (or `.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
}
```
## Advanced: Direct CLI
Use direct execution for single payload debugging.
```bash theme={null}
deepline tools execute apollo_search_people --payload '{}' --json
```
### CLI flags
| Flag | Description |
| --------------------------- | --------------------------------------------------- |
| `--json` | Print machine-readable output. |
| `--wait` | Wait for terminal provider status when supported. |
| `--debug` | Enable wait mode with additional status/log output. |
| `--wait-timeout SECONDS` | Max seconds to wait in wait mode. |
| `--poll-interval SECONDS` | Polling interval in seconds during wait mode. |
| `--timeout SECONDS` | Request timeout in seconds. |
| `--connect-timeout SECONDS` | Connection timeout in seconds. |
## Cost
* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.
* Billing mode: `no_bill`.