Apollo icon

Apollo

Interact with Apollo API
Join our community

Actions7

Overview

The "Search People" operation in the "Person" resource allows users to query and filter people data from the Apollo API based on a wide range of criteria. This node is useful for scenarios such as lead generation, recruiting, market research, or sales prospecting where you want to find individuals matching specific job titles, locations, seniority levels, employer characteristics, technology usage, and more.

For example, a recruiter could use this node to find people with certain job titles in specific cities whose employers are actively hiring, or a sales team might search for contacts at companies using particular technologies within a revenue range.

Properties

Name Meaning
Job Titles Job titles to include; person must match any of these titles
Include Similar Titles Whether to include people with similar job titles to those listed (true/false)
Keywords A string of words to filter results on
Person Locations Cities, states, or countries where people live
Person Seniorities Job seniority levels at current employer
Organization Locations Company headquarters locations (city, state, or country)
Organization Domains Employer domains (e.g., apollo.io)
Contact Email Statuses Email status filters: verified, unverified, likely to engage, unavailable
Organization IDs Apollo organization IDs to include in results
# Employees (Ranges) Employee count ranges (e.g., 1-10, 5000-10000)
Revenue Range Min Minimum employer revenue (whole number)
Revenue Range Max Maximum employer revenue (whole number)
Tech UIDs - Using All Of Return people whose employer uses all listed technologies
Tech UIDs - Using Any Of Return people whose employer uses any of the listed technologies
Tech UIDs - Not Using Any Of Exclude people whose employer uses any of the listed technologies
Active Job Titles at Employer Job titles listed in active postings at the employer
Employer Job Locations Locations of jobs being actively recruited by the employer
# Active Job Postings Min Minimum number of active job postings at employer
# Active Job Postings Max Maximum number of active job postings at employer
Job Posted Date Min Earliest date when jobs were posted (YYYY-MM-DD)
Job Posted Date Max Latest date when jobs were posted (YYYY-MM-DD)
Page Page number of results to retrieve
Per Page Number of results per page

Output

The node outputs JSON data containing the search results of people matching the specified filters. The structure typically includes an array of person objects with detailed information such as names, job titles, contact details, employer information, and other metadata returned by the Apollo API.

If binary data is returned (not indicated here), it would represent attachments or files related to the person records, but this operation primarily returns structured JSON data.

Dependencies

  • Requires an API key credential for authenticating with the Apollo API.
  • The base URL defaults to https://api.apollo.io but can be overridden via credentials configuration.
  • No additional external dependencies beyond the Apollo API.

Troubleshooting

  • Common Issues:

    • Invalid or missing API key will cause authentication errors.
    • Incorrectly formatted filter values (e.g., date strings not in YYYY-MM-DD format) may result in request failures.
    • Requesting pages beyond available results may return empty arrays.
    • Overly broad queries may return large datasets causing performance issues or rate limiting.

  • Error Messages:

    • Authentication errors: Check that the API key credential is correctly configured and valid.
    • Validation errors: Ensure all input properties conform to expected formats and types.
    • Rate limit exceeded: Reduce request frequency or paginate results properly.

Links and References

Discussion