Skip to main content

apollo-leads

Unofficial helper for the official Apollo.io API. Uses your own API key (a master key is required for search). Enrichment consumes Apollo credits.

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).

Metadata

Release files for apollo-leads 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for apollo-leads 0.1.0
File Size Uploaded
apollo_leads-0.1.0.tar.gz 3.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for apollo-leads 0.1.0
File Interpreter ABI Platform
apollo_leads-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 6.7 kB

Release files / apollo_leads-0.1.0.tar.gz

Download URL apollo_leads-0.1.0.tar.gz
Size 3.1 kB
Tags Source
SHA-256 checksum
How to use checksums
2b13b44699277fb0b671f4bae597049db3ab6609d2875b838b22edf0c5022a33
BLAKE2b-256 checksum
How to use checksums
6ef8419e11ed2b3a4d2ef8a85456c24df447801371ed561ee673383818dcfd8e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.9

Release files / apollo_leads-0.1.0-py3-none-any.whl

Download URL apollo_leads-0.1.0-py3-none-any.whl
Size 3.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
caf4b421cec251cf96bb14c5b583e4f9d5c777d90f718ff12d20189d3c335cb8
BLAKE2b-256 checksum
How to use checksums
d0284e9ebac2ef1cca66f40cdbbbf9fd2f2b65f62c59b2ef3de690a962bbe829
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.9

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page