Skip to main content

PyPI

TrustCaptcha for Python — GDPR-compliant, privacy-first CAPTCHA

Protect websites and apps against bots and spam with a privacy-first, EU-hosted CAPTCHA solution.

What is TrustCaptcha?

TrustCaptcha combines proof-of-work, an AI bot-score and custom security rules to stop automated bot abuse — without image marking or puzzles

Key perks:

  • Privacy-friendly & GDPR-compliant – data processed exclusively in Europe
  • No visual challenges – users never label images or solve quizzes
  • Fully themable widget – matches any brand and design and improves your user flow
  • Conversion-safe – near-zero user drop-off compared to legacy CAPTCHAs

Read the full TrustCaptcha product overview for technical details and the security concept.

Get started

  1. Create an account: sign up / sign in.
  2. Choose a CAPTCHA: pick an existing one or create a new one.
  3. Embed the widget: implement the TrustCaptcha widget into your website or app.
  4. Validate result: validate the CAPTCHA verification result in your backend.

Need a walkthrough? See the Python integration guide.

Basic Python integration

  1. Install the dependency
pip install trustcaptcha
  1. Retrieve the verification result
from trustcaptcha.trust_captcha import TrustCaptcha

# Retrieving the verification result
try:
    trust_captcha = TrustCaptcha("<your_api_key>")
    verification_result = trust_captcha.get_verification_result("<verification_token_from_your_client>")
except Exception as e:
    # Fetch verification result failed - handle error
    print(f"Failed to fetch verification result: {e}")
    return jsonify({'error': 'Captcha verification failed'}), 500
  1. Act on the result
# Act on the verification result
if verification_result.verification_passed is not True or verification_result.score > 0.5:
    print("Verification failed or bot score > 0.5 – possible automated request.")

Congratulations — you have successfully validated the result of the CAPTCHA!

For detailed implementation instructions, read the Python integration guide.

Other pre-built integrations

TrustCaptcha ships ready-made integrations for popular stacks:

  • Platforms like WordPress, Joomla, CraftCMS or Keycloak
  • Frontends like JavaScript, Angular, React or Vue.js
  • Backends like Node.js, PHP, Python, Java, Ruby, Rust, Go or DotNet
  • Mobile Applications like iOS, Android, React Native or Flutter

Discover all our pre-built Integrations on our website.

Get support

Questions? We will be happy to help!

Metadata

Release files for trustcaptcha 3.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for trustcaptcha 3.0.0
File Size Uploaded
trustcaptcha-3.0.0.tar.gz 11.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for trustcaptcha 3.0.0
File Interpreter ABI Platform
trustcaptcha-3.0.0-py3-none-any.whl Python 3 none any Details

Total release size: 20.8 kB

Release files / trustcaptcha-3.0.0.tar.gz

Download URL trustcaptcha-3.0.0.tar.gz
Size 11.0 kB
Tags Source
SHA-256 checksum
How to use checksums
3b712bb431381f1e8e35d0a4c7c9c9197f154f9eff83c83dc99ab0c082fdcd22
BLAKE2b-256 checksum
How to use checksums
a16eb238e36788e7a3f6d397e47ff55252e68e3574b7113d938540d90c0df685
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.13

Release files / trustcaptcha-3.0.0-py3-none-any.whl

Download URL trustcaptcha-3.0.0-py3-none-any.whl
Size 9.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cb84bfd1b85097cf5669d222d7abdce9db8179f0a2abb5d827ec99a8a0d678f0
BLAKE2b-256 checksum
How to use checksums
7d1f522fe4e973eaf0280ae29731578101bf130fcb92efa69ce09016edb75ae3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.13
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page