Metadata-Version: 2.4
Name: verifydating
Version: 1.1.0
Summary: Official Python SDK for VerifyDating Real-Time Facial Scam Intelligence, Romance Scam & Pig-Butchering Blacklist API (5,842+ Official Dossiers)
Home-page: https://verifydating.net/api/v1/dating-docs
Author: VasileDev Group
Author-email: support@verifydating.net
Project-URL: Homepage, https://verifydating.net
Project-URL: Documentation, https://verifydating.net/api/v1/dating-docs
Project-URL: Source, https://github.com/amendamax/verifydating-python-sdk
Project-URL: Tracker, https://github.com/amendamax/verifydating-python-sdk/issues
Keywords: dating catfish romance scam pig-butchering detection facial recognition deepfake defense trust safety identity moderation fbi-ic3 ftc europol iosco
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Topic :: Security
Classifier: Topic :: Software Development :: Libraries :: Python Modules
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: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license-file
Dynamic: project-url
Dynamic: requires-python
Dynamic: summary

# 🛡️ VerifyDating Python SDK (`verifydating`)

[![PyPI version](https://img.shields.io/pypi/v/verifydating.svg?color=ff2d78)](https://pypi.org/project/verifydating/)
[![License: MIT](https://img.shields.io/badge/License-MIT-purple.svg)](https://opensource.org/licenses/MIT)
[![Python Versions](https://img.shields.io/pypi/pyversions/verifydating.svg)](https://pypi.org/project/verifydating/)
[![API Status](https://img.shields.io/badge/API-Online%20(99.99%25)-success)](https://verifydating.net/api/v1/dating-docs)

The official Python client library for the **[VerifyDating.net](https://verifydating.net/api/v1/dating-docs) B2B Anti-Catfish, Romance Scam & Pig-Butchering Intelligence API**.

Protect dating platforms, social communities, classified marketplaces, and trust & safety workflows against fake profiles, stolen photos, AI deepfakes, and organized romance-crypto ("Pig Butchering") syndicates across **5,842+ verified official dossiers** (`FBI IC3`, `FTC`, `Europol`, `UN`, `ASIC`, `SFC`, `CySEC`, `CONSOB`, `CSSF`, and `IOSCO`).

---

## ⚡ Key Features

- 🎯 **Sub-100ms Facial Screening**: Detect catfish profiles instantly upon user registration.
- 🤖 **Deepfake AI Detection**: Identify synthetic generative AI faces (Midjourney, Stable Diffusion, StyleGAN).
- 🗄️ **5,842+ Official Romance & Pig-Butchering Dossiers**: Cross-reference verified romance scam archetypes and regulator-blacklisted investment-romance domains across **82+ global authorities**.
- 🛑 **Automated Moderation Actions**: Pre-calculated decision recommendations (`APPROVE_PROFILE`, `REQUEST_LIVE_ID`, `REJECT_PROFILE_AND_AUTO_BAN`).
- 🔒 **Zero External Dependencies**: Lightweight Vanilla Python client using the standard library.

---

## 📦 Installation

```bash
pip install --upgrade verifydating
```

---

## 🚀 Quickstart

### 1. Screen a Profile Picture via Image URL

```python
from verifydating import Client

# Initialize client (defaults to free developer sandbox if no api_key passed)
client = Client(api_key="vd_live_YOUR_API_KEY")

# Check a profile photo URL
result = client.check_face(image_url="https://example.com/uploads/user_avatar.jpg")

print(f"Scam Probability: {result.scam_probability}%")
print(f"Risk Level: {result.risk_level}")
print(f"Verdict: {result.verdict}")
print(f"Action: {result.action_recommendation}")

if result.is_catfish:
    print(f"🚨 AUTO-BAN TRIGGERED: Profile photo matches {result.forensic_details.matches_count} known scam syndicates.")
```

### 2. Query the 5,842+ Romance & Pig-Butchering Dossiers Database

```python
from verifydating import Client

client = Client()
search = client.check_dossier("pig-butchering")

print(f"Status: {search['status']} (Total matches: {search['total_matches']})")
for dossier in search["results"][:3]:
    print(f"- {dossier['persona_name']} [{dossier['scam_category']}] -> {dossier['dossier_url']}")
```

### 3. Screen a Local Image File Upload

```python
from verifydating import Client

client = Client(api_key="vd_live_YOUR_API_KEY")

with open("user_upload.jpg", "rb") as image_file:
    result = client.check_face(image_bytes=image_file.read())

if result.action_recommendation == "REJECT_PROFILE_AND_AUTO_BAN":
    # Automatically reject registration in your dating backend
    ban_user(user_id=123)
```

---

## 📊 Response Object Schema

`FaceCheckResult` properties:

| Field | Type | Description |
| :--- | :--- | :--- |
| `scam_probability` | `int` | Risk score from 0 (Safe) to 100 (High-Risk Romance Scam) |
| `risk_level` | `str` | `LOW_RISK_VERIFIED`, `MODERATE_SUSPICIOUS`, `CRITICAL_ROMANCE_SCAM_FLAG` |
| `action_recommendation` | `str` | `APPROVE_PROFILE`, `REQUEST_LIVE_ID`, `REJECT_PROFILE_AND_AUTO_BAN` |
| `verdict` | `str` | Human-readable forensic summary |
| `is_catfish` | `bool` | `True` if `scam_probability >= 70` |
| `forensic_details` | `object` | Sub-object containing `matches_count`, `deepfake_probability`, and `scammer_info` |
| `quota` | `object` | Remaining requests in current billing cycle |

---

## 🧪 Developer Sandbox (100 Free Scans/Month)

Need a free API key? Generate one instantly via Python:

```python
from verifydating import Client

client = Client()
key_info = client.generate_sandbox_key(email="developer@yourdatingapp.com")
print(f"Your API Key: {key_info['api_key']}")
```

---

## 🏢 Pricing Plans

| Plan | Monthly Price | Monthly Scans | Features |
| :--- | :---: | :---: | :--- |
| **Developer Free** | **$0** | 100 scans | Sandbox testing, JSON REST |
| **Starter App** | **$49** | 2,500 scans | Real-time registration screening |
| **Pro Growth** | **$99** | 25,000 scans | Deepfake AI detection & Auto-ban Webhooks |
| **Enterprise Scale** | **$199** | 100,000+ scans | Dedicated SLA (99.99%) & Custom Scam Hash Stream |

For enterprise contracts and high-volume streams, contact [support@verifydating.net](mailto:support@verifydating.net).

---

## 📄 License

MIT License © 2026 VasileDev Group (EU VIES: `IT04226190041`) / VerifyDating.net
