🛡️ VerifyDating Python SDK (verifydating)

The official Python client library for the VerifyDating.net B2B Anti-Catfish & Facial Scam Intelligence API.

Protect dating platforms, social communities, classified marketplaces, and trust & safety workflows against fake profiles, stolen model photos, AI deepfakes, and organized romance scam syndicates.

⚡ 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).
• 🗄️ Global Stolen Face Database: Cross-reference 480,000+ monitored stolen identities and romance scam photo signatures.
• 🛑 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 standard library.

📦 Installation

pip install verifydating

🚀 Quickstart

1. Screen a Profile Picture via Image URL

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. Screen a Local Image File Upload

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:

🧪 Developer Sandbox (100 Free Scans/Month)

Need a free API key? Generate one instantly via 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

For enterprise contracts and high-volume streams, contact support@verifydating.net.

📄 License

MIT License © 2026 VasileDev Group / VerifyDating.net