GuidesRecipesAPI ReferenceChangelog
Changelog
Start typing to search…
Back to All

August 2025 Update

3 months ago by Lorenzo Roveda

🌊 August 2025 Update: We launched Trustfull Session for real‑time 0–1000 session risk, added a LinkedIn AI Agent in Domain for accuracy and control, and introduced an AliExpress phone check to boost verification._

TRUSTFULL SESSION — Real‑time Session Risk with Device, Network, and Behavior Signals

Trustfull Session helps you separate legitimate users from automation and suspicious setups during key flows like signup and login. Session collects device, network, and behavioral signals, then delivers a transparent 0–1000 risk score and detailed raw data so you can confidently block bots, flag suspicious sessions, and let legitimate users through—all in real time.

🔍 Key Features

Session verifies device and browser integrity, inspects network risk (VPN/proxy/hosting, blacklist recency, geo–timezone match), and measures human interaction cadence (moves, clicks, scrolls) to produce a 0–1000 session score with cluster and a session_id for secure S2S retrieval.

  • 🧠 Session risk scoring: 0–1000 score plus cluster labels from very_low to very_high.
  • 🖥️ Device and browser integrity: Headless, webdriver, spoofing, plugin and mime anomalies, viewport and GPU checks to catch automation and emulation.
  • 🌐 Network intelligence: IP risk, hosting/VPN/proxy flags, blacklist recency and counts, ISP type, geo and timezone consistency.
  • 🖱️ Human‑vs‑bot behavior: Mouse movement, clicks, wheel events, timing signals to spot scripted sessions.

📊 Representative Example Output

Below a selection of the responses, check the full example and feature list in the API Documentation.

{
  "score": 649,
  "score_cluster": "high",
  "transaction_id": "158db860-67e6-4ef7-8162-1a23a5e16cf5",
  "session_id": "session-123",
  "device_request_time": "2024-12-12T10:00:00Z",

  "navigator_browser_name": "Chrome",
  "navigator_type": "Desktop",
  "navigator_web_driver": false,
  "has_headless_app_version": true,
  "has_headless_user_agent": true,
  "has_puppeteer_extra_stealth": false,
  "has_spoofed_device": true,
  "user_agent_match": true,
  "language_match": true,
  "mime_types_match": true,
  "window_viewport_dimension_match": true,
  "has_window_outer_dimension_anomaly": true,

  "mouse_movement": 10,
  "click_count": 10,
  "wheel_count": 10,
  "time_elapsed_ms": 11000,

  "ip": "192.168.0.1",
  "ip_is_hosting": true,
  "ip_is_vpn": false,
  "ip_is_proxy": false,
  "ip_black_list_count": 5,
  "ip_country_code": "US",
  "ip_timezone": "CET",
  "ip_timezone_request_time": "night"
...
}

Where to go next

See the step‑by‑step Bot Detection and Session Guide for a simple walkthrough: adding the JS snippet, choosing when to submit a session (after a form submit or on page load), and how to retrieve results from your backend using the session_id. It also explains how to read the score and clusters and what common device, network, and behavior checks mean for risk decisions.

To implement Session, see endpoints and schemas in the API Reference and explore all signals in the Signals Catalogue. The API Reference shows exact request and response formats, authentication, required headers, and the structured fields you’ll receive, plus the full catalogue of session signals if you need deeper inspection.

TRUSTFULL DOMAIN — LinkedIn Accuracy & Control via AI Agent

An AI Agent now powers LinkedIn data extraction for Trustfull Domain. It validates results across multiple sources, applies policy‑driven controls, and exposes confidence so you can trust and tune outcomes.

🔍 Key Features

  • 📊 Company statistics: Followers, employee count, verification status, and post activity to gauge reach and authenticity
  • 📝 Qualitative insights: Company description, LinkedIn URL, industry, location, and type for contextual understanding
  • 🎯 Confidence and control: AI-driven confidence scores, extraction method transparency, and policy-based control modes for tunable accuracy

📊 Example Output

{
    "has_linkedin": true,
    "linkedin_url": "https://www.linkedin.com/company/trustfull",
    "linkedin_follower_count": 8089,
    "linkedin_company_size": "10,50",
    "linkedin_avg_articles_likes_count": 42,
    "linkedin_first_article_date": "2024-12-04",
    "linkedin_last_article_date": "2024-12-04"
}
  • has_linkedin (boolean) — Indicates if the domain has a Company on LinkedIn corresponding to the domain.
  • linkedin_url (string) — The link to the LinkedIn company corresponding to the domain.
  • linkedin_follower_count (integer) — Specifies the number of followers of the LinkedIn company corresponding to the domain.
  • linkedin_company_size (string) — Specifies the cluster size of the LinkedIn company corresponding to the domain.
  • linkedin_avg_articles_likes_count (integer) — The average count of article likes of the LinkedIn company corresponding to the domain.
  • linkedin_first_article_date (string) — The first available article date of the LinkedIn company corresponding to the domain.
  • linkedin_last_article_date (string) — The last available article date of the LinkedIn company corresponding to the domain.

📱 TRUSTFULL PHONE — AliExpress Account Check

Using our inhouse solution, Trustfull Phone now includes a new signal: AliExpress phone! The signal indicates whether the phone number is associated with an AliExpress account.

📊 Example Output

{
  "claims": ["phone"],
  "has_aliexpress": true
}
  • has_aliexpress (boolean) — Indicates if the phone number is associated with an AliExpress account.

📚 Resources