Apollo: Search People With Match

Search people by job title, seniority, location, and company domain, then automatically enrich each match with full name, email, and LinkedIn profile.

Tool ID: apollo_search_people_with_match

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_with_match',
  {
    "page": 123,
    "per_page": 123,
    "person_titles": [
      "example"
    ]
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute apollo_search_people_with_match --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": {
    "search": {
      "total_entries": 123,
      "people": [
        {}
      ],
      "pagination": {}
    },
    "people": [
      {}
    ],
    "total_candidates": 123
  }
}

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

Input reference

Prospect people from Apollo’s global dataset, then automatically enrich the discovered IDs. This first runs no-credit preview search (mixed_people/api_search) and then paid bulk match on the returned people, so use it when you want search coverage but need fully enriched person rows back in one step.

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.
`payload.reveal_personal_emails`	`boolean`	No	`false`	When true, attempt personal email reveal during auto-match enrichment. WARNING: Apollo primarily returns work emails even with this flag (~70% work, ~30% personal). Do NOT use Apollo for personal email discovery - use Fullenrich or BetterContact instead.

Output reference

Apollo no-credit preview search + paid auto-match result. Uses no-credit /mixed_people/api_search for discovery, then paid /people/bulk_match for returned IDs. Use result.data.people (or <column>.data.people) as the enriched contact list.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	Composite payload with `search` preview metadata and enriched `people` matches.
`result.data.search`	`object \| null`	No	—	Apollo native people-search payload. Shape is top-level `{ total_entries, people, pagination }`. Important: results may include obfuscated last names (e.g., `last_name_obfuscated`). Do not build email patterns from obfuscated names. Use `apollo_bulk_people_enrichment` with `details: [{ id }]` to retrieve full contact fields from Apollo person IDs.
`result.data.search.total_entries`	`number`	No	—	Total number of matching people records.
`result.data.search.people`	`array`	No	—	—
`result.data.search.pagination`	`record`	No	—	—
`result.data.people`	`array`	No	—	—
`result.data.total_candidates`	`number`	No	—	—
`result.data.attempted_matches`	`number`	No	—	—
`result.data.unique_enriched_records`	`number`	No	—	—
`result.data.missing_records`	`number`	No	—	—
`result.meta`	`record`	No	—	Additional response metadata (status, paging).

Deepline cost

Pricing model: per_result (per result).
Estimated Deepline credits: 0.17 per pricing unit.

​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