Apollo icon

Apollo

Interact with Apollo API

Person → Search People

AI-generated

Summary

Search people using filters such as job titles, locations, seniority, employer details, and technology usage. Results are paginated and returned as a list of matching person records.

Inputs

  • person_titles — Job titles to include (person must match any). Multiple values allowed. Sent as query parameter 'person_titles[]'.
  • include_similar_titles — Whether to include people with similar job titles to those listed. Default: true. Sent as query parameter 'include_similar_titles'.
  • q_keywords — A string of words to filter results on. Sent as query parameter 'q_keywords'.
  • person_locations — Cities, states, or countries where people live. Multiple values allowed. Sent as query parameter 'person_locations[]'.
  • person_seniorities — Job seniority at current employer. Multiple values allowed. Sent as query parameter 'person_seniorities[]'.
  • organization_locations — Company HQ locations (city, state, or country). Multiple values allowed. Sent as query parameter 'organization_locations[]'.
  • q_organization_domains_list — Employer domains (e.g. apollo.io). Multiple values allowed. Sent as query parameter 'q_organization_domains_list[]'.
  • contact_email_status — Email status to filter by (verified, unverified, likely to engage, unavailable). Multiple values allowed. Sent as query parameter 'contact_email_status[]'.
  • organization_ids — Apollo organization IDs to include in results. Multiple values allowed. Sent as query parameter 'organization_ids[]'.
  • organization_num_employees_ranges — Employee count ranges like 1,10 or 5000,10000. Multiple values allowed. Sent as query parameter 'organization_num_employees_ranges[]'.
  • revenue_range_min — Minimum employer revenue (whole number). Default: 0. Sent as query parameter 'revenue_range[min]'.
  • revenue_range_max — Maximum employer revenue (whole number). Default: 0. Sent as query parameter 'revenue_range[max]'.
  • currently_using_all_of_technology_uids — Return people whose employer uses all listed technologies. Multiple values allowed. Sent as query parameter 'currently_using_all_of_technology_uids[]'.
  • currently_using_any_of_technology_uids — Return people whose employer uses any of the listed technologies. Multiple values allowed. Sent as query parameter 'currently_using_any_of_technology_uids[]'.
  • currently_not_using_any_of_technology_uids — Exclude people whose employer uses any of the listed technologies. Multiple values allowed. Sent as query parameter 'currently_not_using_any_of_technology_uids[]'.
  • q_organization_job_titles — Job titles listed in active postings at the employer. Multiple values allowed. Sent as query parameter 'q_organization_job_titles[]'.
  • organization_job_locations — Locations of jobs being actively recruited by the employer. Multiple values allowed. Sent as query parameter 'organization_job_locations[]'.
  • organization_num_jobs_range_min — Minimum number of active job postings at employer. Default: 0. Sent as query parameter 'organization_num_jobs_range[min]'.
  • organization_num_jobs_range_max — Maximum number of active job postings at employer. Default: 0. Sent as query parameter 'organization_num_jobs_range[max]'.
  • organization_job_posted_at_range_min — Earliest date when jobs were posted (YYYY-MM-DD). Sent as query parameter 'organization_job_posted_at_range[min]'.
  • organization_job_posted_at_range_max — Latest date when jobs were posted (YYYY-MM-DD). Sent as query parameter 'organization_job_posted_at_range[max]'.
  • page — Page number of results to retrieve. Default: 1. Sent as query parameter 'page'.
  • per_page — Number of results per page. Default: 10. Sent as query parameter 'per_page'.

Output shape

The operation returns a paginated list of person records matching the applied filters. Exact field-level return shape is not detailed in the provided source; the node routes the request to POST /api/v1/mixed_people/search and returns Apollo's standard search response.

Input parameters are sent as HTTP query parameters. The node handles pagination via 'page' and 'per_page'. Batching, proxy, timeout, and SSL settings are configured via the node's 'requestOptions' and are not specific to the filter logic.

Examples

Example 1: Find people with specific job titles and revenue range

Set 'person_titles' to ['CEO', 'Founder'], 'revenue_range_min' to 1000000, 'revenue_range_max' to 10000000, 'page' to 1, 'per_page' to 25.

Discussion