Quick Start Integrations API Reference

Inicio Rapido

Get CAPTCHA Oculto running on your site in 5 minutes.

1 Create an Account

2 Register Your Site

Once logged in, go to your Dashboard and click "Add Site". Enter your domain name (e.g., mysite.com).

You'll receive two keys:

Site Key (sk_...) - Public, goes in your HTML
API Key (ak_...) - Secret, goes in your backend server

3 Add the Script to Your HTML

Add this single line before the closing </body> tag on any page with a form:

			<script src="https://api.captchaoculto.com/client.js"
  data-co-site-key="YOUR_SITE_KEY" defer></script>
		

Replace YOUR_SITE_KEY with the Site Key from your dashboard. That's it for the frontend!

4 Verify on Your Server

When a form is submitted, CAPTCHA Oculto adds a hidden field called _co_verdict. Send this token to our API to verify it:

			POST https://api.captchaoculto.com/verify
Content-Type: application/json

{
  "token": "THE_VERDICT_TOKEN",
  "api_key": "YOUR_API_KEY"
}

// Response:
{
  "valid": true,
  "score": 12,
  "classification": "human",  // "human", "suspicious", or "bot"
  "threshold": 50
}
		

A score of 0-25 means human, 26-50 means suspicious, and 51-100 means bot. Use the classification field for easy decisions.

5 Handle the Result

Based on the classification, decide what to do:

human - Process the form normally
suspicious - Process but flag for review
bot - Reject silently (return a fake success to the bot so it thinks it worked)

6 Monitor in the Dashboard

Visit your Dashboard to see real-time statistics: how many verifications, score distributions, and recent detections.

Next steps:

Check out our Integration Guides for language-specific SDKs (PHP, Node.js, WordPress) that simplify server-side verification.