Ghost Captcha API

Documentation

Embed the Ghost Captcha widget on any website using a single script tag and HTML data attributes. The API automatically builds the UI, applies your custom styling, and handles verification.

1. Include the Script

Place this right before your closing </body> tag. It contains everything needed.

<script src="https://api.ghostcaptcha.com/v2/widget.js"></script>

2. Add Data Attributes to your Button

Add data-ghost-captcha="true" to any button. You can fully customize the modal using the attributes below. The moving static noise will always remain black/white.

3. Example Integration

<button 
    data-ghost-captcha="true" 
    data-callback="handleSuccess"
    data-bg="#ffffff"
    data-text="#ffffff"
    data-btn-bg="#000000"
    data-btn-text="#ffffff"
    data-outline="#e2e8f0"
    data-font="'Inter', sans-serif">
    Submit Form
</button>

<script>
    function handleSuccess() {
        alert("User verified as human!");
        // Submit your form via AJAX or update UI
    }
</script>