Apollo: Search People

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

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.

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

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.

{
  "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.

Output reference

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.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	Apollo native payload with top-level `{ total_entries, people, pagination }` 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).

Deepline cost

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

​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