Metadata-Version: 2.5
Name: apollo-leads
Version: 0.1.0
Summary: Find contacts (or top decision makers) at a company via the official Apollo.io API.
Requires-Python: >=3.9
Requires-Dist: requests>=2.28
Description-Content-Type: text/markdown

# apollo-leads

Unofficial helper for the official [Apollo.io](https://apollo.io) API. Uses your own API key
(a **master** key is required for search). Enrichment consumes Apollo credits.

```python
from apollo_leads import find_contacts

# named person -> 1 contact
find_contacts("Brightpath Analytics", "Alex Rivera", api_key="...")

# no person -> top 3 decision makers (CEO / founder / CXO / data & AI leaders)
find_contacts("Brightpath Analytics", api_key="...")   # or set APOLLO_API_KEY
```

Each contact is a dict: `name, title, company, email, phone, company_phone, linkedin_url`.
No match returns `[]`.

| Parameter | Default | |
|---|---|---|
| `company` | required | Company name |
| `person` | `None` | Blank -> top decision makers |
| `api_key` | env `APOLLO_API_KEY` | |
| `top_n` | `3` | Decision makers to return |

Errors (all subclass `ApolloError`): `MissingAPIKeyError`, `InputError`, `AuthError` (401),
`MasterKeyRequiredError` (403), `RateLimitError` (429 after retries).
