Metadata-Version: 2.4
Name: people-enrichment
Version: 0.1.0
Summary: Work email, phone & company enrichment for Python — verified work emails + direct phones from a name + domain, plus B2B company, domain & email enrichment. Free company demo, no key.
Author: GoCreative
License: MIT
Project-URL: Homepage, https://api.gocreativeai.com/p/data-and-tools
Project-URL: Documentation, https://api.gocreativeai.com/v1/docs
Project-URL: Free demo, https://api.gocreativeai.com/demo/enrich-company/stripe.com
Keywords: enrichment,people-enrichment,company-enrichment,email-finder,work-email,phone-finder,lead-enrichment,b2b,prospecting,sales,firmographics,data-enrichment,contact-enrichment
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Office/Business
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# people-enrichment

**Work email, phone & company enrichment for Python.** Turn a name + company domain into a **verified work email, direct phone, and LinkedIn URL** — plus B2B **company, domain, and email** enrichment. Real, deliverability-checked contacts from a multi-provider waterfall, not pattern guesses.

- ✅ **Free company-enrichment demo, no signup.**
- 📧 **Verified work email + direct mobile** from `"Name domain.com"`.
- 🏢 **Company firmographics** — description, industry, website, socials, tech.
- 🔌 **Zero dependencies**, Python 3.8+. Pay-per-call (card or USDC via x402) — no seat license, no 3-seat minimum, no annual contract.

## Install

```bash
pip install people-enrichment
```

## Quickstart (free, no key)

```python
from people_enrichment import Client

c = Client()  # free company-enrichment demo, rate-limited

print(c.company("stripe.com"))
# {'company_name': 'Stripe', 'description': 'Stripe is a financial services platform...',
#  'website': 'https://stripe.com', 'social': {...}, 'emails': [...]}
```

## Full access (paid)

Get an API key instantly with a card at **https://api.gocreativeai.com/credits/buy** (or pay-per-call in USDC via [x402](https://api.gocreativeai.com/no-api-key) — no key at all):

```python
c = Client(api_key="gck_...")

c.people("Patrick Collison stripe.com")  # verified work email + mobile + LinkedIn
c.email("jane@acme.com")                 # validate + enrich an email
c.company("stripe.com")                  # full company enrichment
c.domain("stripe.com")                   # DNS + WHOIS + TLS footprint
```

## Methods

| Method | Free demo | Paid endpoint | Returns |
|---|---|---|---|
| `company(domain)` | ✅ | `/v1/enrich/company` | firmographics, description, website, socials |
| `people(query)` | — | `/v1/enrich/people` | verified work email + direct phone + LinkedIn |
| `email(query)` | — | `/v1/enrich/email` | email validation + enrichment |
| `domain(domain)` | — | `/v1/enrich/domain` | DNS + WHOIS + TLS |

All methods return parsed JSON (`dict`). Errors raise `EnrichmentError` with a clear message (402 → how to get a key, 429 → demo quota reached).

## Why this vs Hunter / Apollo / Snov.io / Prospeo

The API **is** the product — full programmatic access on every tier (no $149/mo API paywall, no 3-seat minimum), verified contacts from a multi-provider waterfall, and a genuinely usable free tier. See: [vs Hunter](https://api.gocreativeai.com/vs/hunter) · [vs Apollo](https://api.gocreativeai.com/vs/apollo) · [vs Snov.io](https://api.gocreativeai.com/vs/snovio) · [vs Prospeo](https://api.gocreativeai.com/vs/prospeo).

## Disclaimer

Enrichment draws on public + partner data sources; verify before outreach and comply with applicable privacy/anti-spam law (GDPR/CAN-SPAM). Absence of a result is not a guarantee that none exists.

## License

MIT © GoCreative · [Docs](https://api.gocreativeai.com/v1/docs)
