[Apollo] People Search
The [Apollo] People Search block queries the Apollo.
Search for people in Apollo.io by criteria
The [Apollo] People Search block queries the Apollo.io database to find people matching specific criteria. You can describe your target audience using a natural language smart query — for example, "marketing directors at SaaS companies in NYC" — or use the advanced parameter fields to filter by job title, seniority, location, company size, revenue range, email status, and technology usage. Both approaches can be combined, with advanced params supplementing or overriding what the smart query produces.
The block returns a results object containing the matched people from Apollo. Optionally, you can enable enrichment for each person to include full contact details, and separately enable enrichment for their organizations to include full company details. Pagination is controlled through the limit and page fields, letting you retrieve specific slices of a larger result set. The output is stored as JSON in a variable you define.
This block fits into workflows that involve prospecting, lead generation, or contact list building. It is commonly used alongside CRM update blocks, outreach automation, or data enrichment pipelines where you need to identify and qualify a set of contacts based on firmographic or technographic criteria before taking further action.
What you can build
Real-world workflows powered by the [Apollo] People Search block.
Outbound Lead List Building
Search for contacts matching an ideal customer profile — such as VP-level buyers at mid-market software companies — and feed the results into an outreach sequence.
Technographic Prospecting
Filter prospects by the technologies they currently use or do not use to identify accounts that are likely candidates for a competing or complementary product.
Territory-Based Contact Discovery
Scope searches by person location or organization location to build contact lists for specific geographic sales territories.
Enriched Contact Data Pipeline
Enable both person and organization enrichment to retrieve full contact and company details, then pass the enriched records into a CRM or data warehouse.
Recruiting Candidate Search
Use title and seniority filters to surface professionals in specific roles, supporting talent sourcing workflows that require structured contact data.
Paginated Bulk Export
Use the limit and page parameters to iterate through large result sets across multiple workflow runs, assembling a complete dataset of matched contacts.
Ready to add [Apollo] People Search to your workflow?
Get Started FreeCommon questions about [Apollo] People Search
What parameters are required to run this block?
The block requires a smartQuery string at minimum. All advanced filter fields — such as personTitles, personLocations, personSeniorities, organizationNumEmployeesRanges, and technology filters — are optional and can be used to supplement or override the smart query. The limit and page fields control how many results are returned and which page of results to retrieve.
What does the block return?
The block returns a results object containing the people matched by Apollo.io. If enrichPeople is enabled, each person record includes full contact details. If enrichOrganizations is enabled, each record also includes full company details. The output is stored as JSON in the variable specified by destinationVar.
How does the smartQuery field work?
The smartQuery field accepts a natural language description of the people you want to find, such as "marketing directors at SaaS companies in NYC". This input is converted into Apollo search parameters automatically. You can also use the advanced params fields alongside the smart query to refine or override specific filters.
What kinds of workflows commonly use this block?
This block is used in lead generation, outbound sales prospecting, recruiting pipelines, and contact enrichment workflows. It is typically connected to downstream blocks that process, store, or act on the returned contact records — such as CRM update blocks or outreach automation steps.
How do I retrieve more than one page of results?
Use the limit field to set the maximum number of results per call and the page field to specify which page of results to retrieve. To collect a full dataset, you can run the block multiple times with incrementing page values.
Related capabilities
[Hunter.io] Find Email
Find an email address for a specific person at a domain using Hunter.io.
[Hunter.io] Enrich Person
Look up professional information about a person by their email address using Hunter.io.
[Hunter.io] Verify Email
Verify whether an email address is valid and deliverable using Hunter.io.
[Hunter.io] Enrich Company
Look up company information by domain using Hunter.io.
[Hunter.io] Domain Search
Search for email addresses associated with a domain using Hunter.io.
[ActiveCampaign] Create Contact
Create or sync a contact in ActiveCampaign.
Add [Apollo] People Search to your workflow
Build powerful AI workflows with drag-and-drop blocks. No coding required.