Apollo.io icon

Apollo.io

Interact with the Apollo.io API

Actions8

Person → Search

AI-generated

Overview

This node performs a search for people based on various filters such as job titles, keywords, locations, seniority levels, organization details, email status, and pagination options. It is useful for scenarios where you need to find specific individuals matching detailed criteria, such as recruiting, sales prospecting, or market research.

Use Case Examples

  1. Search for people with job titles 'Manager' or 'Director' in specific cities.
  2. Filter people by seniority levels like 'C-Suite' or 'VP' within organizations of certain revenue ranges.
  3. Retrieve verified contacts with specific organization domains and paginate through results.

Properties

Name Meaning
Person Titles A list of job titles to filter people by. Multiple titles should be separated by semicolons (e.g., 'Manager; Director').
Keywords Keywords to filter people by. This searches across various fields.
Person Locations A list of locations (cities, states, countries) to filter people by. Separate multiple locations with semicolons.
Seniorities Filter people based on their job seniority level.
Organization Locations Filter based on the location of the organization's headquarters. Separate multiple locations with semicolons.
Organization Domains Filter based on the organization's website domain. Separate multiple domains with semicolons.
Email Status Filter people based on the status of their contact email (e.g., verified, likely to engage).
Organization IDs Filter based on specific Apollo Organization IDs. Separate multiple IDs with semicolons.
Employee Count Ranges Filter based on the number of employees in the organization. Specify ranges separated by semicolons (e.g., '1,10; 11,50').
Min Revenue The minimum annual revenue of the organization (in USD).
Max Revenue The maximum annual revenue of the organization (in USD).
Page The specific page of results to retrieve. Useful for pagination.
Per Page The number of records to return per page. Maximum is 100.

Output

JSON

  • people - Array of people objects matching the search criteria.
  • totalCount - Total number of people found matching the search criteria.
  • page - Current page number of the results.
  • perPage - Number of records returned per page.

Dependencies

  • An API key credential for authentication with the Apollo.io service.

Troubleshooting

  • Ensure the API key credential is correctly configured and has the necessary permissions.
  • Verify that the input filters are correctly formatted, especially semicolon-separated lists.
  • Check pagination parameters to avoid requesting pages beyond the available range.
  • Common error messages may include authentication failures, invalid filter formats, or rate limiting by the Apollo.io API. Resolving these involves checking credentials, input correctness, and API usage limits.

Links

Discussion