> ## Documentation Index
> Fetch the complete documentation index at: https://docs.asteragents.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Apollo Prospect Tool

> Discover new B2B contacts or companies matching an ideal customer profile using Apollo.io filters

## 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](/tools/apollo_enrich) to reveal the verified email only for the people worth contacting.

<Note>
  **Requires Apollo Integration**: Set up the [Apollo.io integration](/integrations/apollo) before agents can use this tool.
</Note>

## 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

| Parameter     | Type   | Required | Description                                                            |
| ------------- | ------ | -------- | ---------------------------------------------------------------------- |
| `entity_type` | string | No       | `contact` (default) to return people, or `company` to return companies |
| `filters`     | object | **Yes**  | Apollo search parameters, passed through to the search. See keys below |
| `page`        | number | No       | 1-based page index (default `1`)                                       |
| `per_page`    | number | No       | Results 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

## Related tools

* [Apollo Enrich](/tools/apollo_enrich) — reveal verified work emails and firmographics for the ids returned here