Metadata-Version: 2.4
Name: apivault-skip-trace
Version: 0.2.0
Summary: Thin Python client for authorized name, address, phone or email lookups through the hosted Skip Trace Apify Actor.
Author: apivault-labs
License-Expression: 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: 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

A thin Python client for authorized name, address, phone and email lookups through the hosted [Skip Trace Actor](https://apify.com/apivault_labs/skip-trace-people-finder).

> **Lawful use only.** This is not a consumer-reporting service. Do not use returned data for credit, employment, housing, insurance, tenant screening or other FCRA-regulated decisions. Verify important information independently.

## Install

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

## Quick start

```python
from apivault_skip_trace import SkipTrace

client = SkipTrace("your_apify_token")

rows = client.search_name(
    "Jane Example",
    location="Springfield, IL",
    max_results=3,
    output_preset="contacts",
)

print("rows returned:", len(rows))
```

The sample is fictional. Replace it only with information you are authorized to process.

## Lookup methods

```python
client.search_name("Jane Example", location="Springfield, IL")
client.search_address("123 Example Ave", "Springfield, IL 62704")
client.search_phone("(202) 555-0182")
client.search_email("jane@example.com")
```

Each method supports a small `max_results` limit and an `output_preset` of `contacts`, `flat`, or `full`. Contacts is recommended for review queues; Full includes the complete public result when available.

## Pricing

- **$6.50 per 1,000 delivered matched-person records**;
- unmatched queries have no result charge;
- the small Actor Start charge and Apify platform usage may still apply;
- no subscription or monthly minimum.

Start with 1–3 results and review match quality before increasing the limit.

## Review-first use case

Read the maintained [contact-enrichment playbook](https://github.com/apivault-labs/skip-trace-people-finder-python/blob/main/guides/review-first-contact-enrichment.md). Keep a manual approval step before CRM import or outreach.

## Resources

- [Skip Trace on Apify](https://apify.com/apivault_labs/skip-trace-people-finder)
- [Python examples](https://github.com/apivault-labs/skip-trace-people-finder-python)
- [n8n node](https://www.npmjs.com/package/n8n-nodes-apivault-skip-trace)

## License

MIT
