API Documentation

A complete guide to integrating and using the SharkEyes API. Learn how to protect your forms with our anti-bot tools.

Introduction to SharkEyes

SharkEyes is a lightweight, high-performance API service designed to protect web forms from spam, bots, and automated scripts. We believe that robust security shouldn’t come at the cost of user experience.

Unlike traditional CAPTCHA solutions, SharkEyes operates silently in the background. It analyzes technical data and behavioral patterns to instantly filter out malicious traffic without forcing humans to solve puzzles.

Why SharkEyes?

Standard CAPTCHAs hurt conversion rates and frustrate legitimate users. SharkEyes changes the game by offering a "zero-friction" environment for your audience while maintaining a titanium shield against automation.

Key Advantages

Zero Friction: No more selecting traffic lights or bicycles. Users don't have to do anything—the system handles the verification automatically.

Privacy-Centric:We do not use invasive tracking or global user profiling. Our analysis is based on technical session parameters, ensuring high anonymity and compliance with privacy standards.

Data-Driven:Instead of resource-heavy neural networks, SharkEyes uses optimized data-analysis algorithms. This ensures lightning-fast response times without slowing down the user's browser.

Built for Modern Bots:Protection against advanced headless browsers, emulators, and sophisticated automation scripts.

Modes of Operation

SharkEyes adapts to your website’s design with two flexible modes:

Mode Description Visual Impact
Visible Displays a minimalist widget that informs the user the form is protected. Subtle UI element
Invisible Runs entirely in the background, triggered by form interaction. Completely hidden

How It Works

Our security engine uses a multi-layered approach to verify requests without relying on invasive AI models:

Technical Fingerprinting:Detection of Headless browsers, Selenium, Puppeteer, and other automated environments

Behavioral Analysis:Identification of anomalies typical of scripts, such as instant field completion or lack of natural interaction.

Cryptographic Challenge:A lightweight, non-intrusive background task that confirms the legitimacy of the client session.

This data-driven approach allows us to stay effective against bots while preserving the speed and privacy of your platform.

Simple Integration

We have simplified the setup process to be as transparent as possible. At this stage, SharkEyes requires no complex SDKs or heavy libraries.

Note:Currently, SharkEyes is integrated via a lightweight JavaScript snippet. You simply include the script on your page and add a container to your form.

Basic Implementation Example:

<!-- Load the SharkEyes widget -->
<script src="https://api.sharkeyes.dev/api/widget.js" async defer></script>

<!-- Add this form to your page -->
<form class="sharkeyes-container" data-sharkeyes></form>