Skip to main content

​
What it does

Apollo Prospect finds people or companies you don’t already have by filtering Apollo’s database — by job title, seniority, location, company domain, employee count, revenue, and keywords. People results are lean previews (id, first name, title, company, and availability flags); emails come back locked until you enrich. Hand each match’s id to Apollo Enrich to reveal the verified email only for the people worth contacting.
Requires Apollo Integration: Set up the Apollo.io integration before agents can use this tool.

​
Key features

  • Filter-based discovery over Apollo’s full B2B database (top of funnel — find the names)
  • Person filters: titles, seniority, person and company location, employer domain, employee-count ranges, email status, keywords
  • Company filters: employee-count ranges, location, industry/keyword tags, name
  • Search is free — no credits spent on discovery
  • Paginate up to 100 results per page
  • Each person preview includes an id ready to pass to Apollo Enrich

​
Parameters

ParameterTypeRequiredDescription
entity_typestringNocontact (default) to return people, or company to return companies
filtersobjectYesApollo search parameters, passed through to the search. See keys below
pagenumberNo1-based page index (default 1)
per_pagenumberNoResults per page, 1–100 (default 25)
Common filters keys for people (entity_type: "contact"): person_titles (array of job titles), person_seniorities (owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern), person_locations, organization_locations (company HQ), q_organization_domains_list (employer domains), organization_num_employees_ranges (e.g. ["1,10","11,50"]), contact_email_status (verified, unverified, likely_to_engage, unavailable), q_keywords. Common filters keys for companies (entity_type: "company"): organization_num_employees_ranges, organization_locations, q_organization_keyword_tags, q_organization_name.

​
Common use cases

​
Find decision-makers at target-sized companies

entity_type: "contact"
filters: {
  "person_titles": ["VP of Sales", "Head of Sales"],
  "person_seniorities": ["vp", "head"],
  "organization_num_employees_ranges": ["51,200"]
}
per_page: 25
Returns VP/Head of Sales leaders at 51–200 employee companies, as previews — feed each id to Apollo Enrich for the email.

​
Find the right person at a specific company

entity_type: "contact"
filters: {
  "person_titles": ["Property Manager", "Community Manager"],
  "q_organization_domains_list": ["realmanage.com"]
}
Surfaces the right persona at a company when you have the domain but no name — then enrich the returned id.

​
Build a target-account list

entity_type: "company"
filters: {
  "organization_num_employees_ranges": ["201,500"],
  "q_organization_keyword_tags": ["software"]
}
Returns software companies in the 201–500 employee range.

​
What you get back

  • results[] — people previews include id, first_name, title, organization.name, and availability flags (has_email, has_direct_phone); company results include firmographics
  • total_matches / total_pages — for company search (people api_search returns previews without a total)
  • page / per_page — the page returned
  • rate_limits — remaining requests for the minute/hour/day window

​
Best practices

  • Prospect first, enrich second — discovery is free; only spend a credit on the people worth contacting
  • Pass the id, not the name — the Apollo person id is the reliable handoff to Apollo Enrich (last names are partially obfuscated in people previews)
  • Filter on the company domain when you can — it targets far more precisely than a name
  • Start broad, then narrow — overly specific filters can return zero matches

​
Troubleshooting

“Provide a non-empty filters object”
  • Pass at least one filter key — see the keys in the Parameters section
“No results returned”
  • Loosen filters; combining many narrow constraints can eliminate all matches
“Apollo denied access (403)”
  • Search requires an Apollo plan with API access — confirm your plan and key permissions
  • Apollo Enrich — reveal verified work emails and firmographics for the ids returned here