Metadata-Version: 2.4
Name: apivault-skip-trace
Version: 0.1.0
Summary: Skip Trace & People Finder — search by name, address, phone or email. Returns addresses, phones, emails, relatives, aliases. Powered by Apify.
Author: apivault-labs
License: MIT
Project-URL: Homepage, https://apify.com/apivault_labs/skip-trace-people-finder
Project-URL: Documentation, https://github.com/apivault-labs/apivault-skip-trace
Project-URL: Repository, https://github.com/apivault-labs/apivault-skip-trace
Project-URL: Issues, https://github.com/apivault-labs/apivault-skip-trace/issues
Keywords: skip-trace,people-search,reverse-phone,reverse-address,public-records,lead-generation,real-estate,apify
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.25.0
Dynamic: license-file

# apivault-skip-trace

Skip Trace & People Finder — Python SDK. Search by name, address, phone, or email. Returns addresses, phones, emails, relatives, aliases, and a match-confidence score.

**US public records. Real-time. No subscription. $6.50/1K lookups.**

[![PyPI](https://img.shields.io/pypi/v/apivault-skip-trace)](https://pypi.org/project/apivault-skip-trace/)
[![Python](https://img.shields.io/pypi/pyversions/apivault-skip-trace)](https://pypi.org/project/apivault-skip-trace/)

## Install

```bash
pip install apivault-skip-trace
```

## Quick Start

```python
from apivault_skip_trace import SkipTrace

st = SkipTrace("your_apify_token")  # get token at apify.com/account#/integrations

# Search by name
results = st.search_name("John Smith", location="Springfield, IL")
for person in results:
    print(person["fullName"], person.get("phones"), person.get("emails"))

# Reverse phone lookup
results = st.search_phone("(202) 555-0182")

# Reverse address lookup
results = st.search_address("123 Main St", "Springfield, IL 62704")

# Reverse email lookup
results = st.search_email("jane.doe@gmail.com")

# Bulk (mixed queries in one call)
results = st.bulk_search(
    names=["John Smith; IL", "Jane Doe; NY"],
    phones=["2025550182"],
    emails=["test@example.com"],
)
```

## What You Get Back

Each person dict contains:

| Field | Description |
|---|---|
| `fullName` | Full name |
| `firstName`, `lastName` | Parsed name components |
| `age`, `birthYear` | Age / birth year when available |
| `currentAddress` | Most recent address |
| `addresses` | All known addresses (current + past) |
| `phones` | Phone numbers with type (mobile/landline) |
| `emails` | Email addresses |
| `relatives` | Names of associated people |
| `aliases` | Also known as / maiden names |
| `matchScore` | Confidence score (0-100) |
| `bestEmail` | Top email (verified deliverable via MX) |

## Pricing

- **$6.50 per 1,000 lookups** (Apify pay-per-event)
- Pay only for matches (empty results are free)
- No subscription, no monthly minimum
- Get $5 free credits at [apify.com](https://apify.com/pricing)

## Get Your API Token

1. Sign up at [apify.com](https://apify.com) (free)
2. Go to [Settings → Integrations](https://console.apify.com/account#/integrations)
3. Copy your API token

## Use Cases

- **Real estate** — find property owners, skip trace vacant homes
- **Debt collection** — locate debtors with updated contact info
- **Sales prospecting** — enrich leads with phone + email
- **Background checks** — verify identity with addresses + relatives
- **Fraud prevention** — cross-reference provided info against public records

## Links

- [Apify Store](https://apify.com/apivault_labs/skip-trace-people-finder) — run in browser, no code
- [API Docs](https://docs.apify.com/api/v2) — REST API reference
- [n8n Node](https://www.npmjs.com/package/n8n-nodes-apivault-skip-trace) — no-code automation

## License

MIT