Explainers

reCAPTCHA Enterprise Site Key vs API Key: Configuration Guide

reCAPTCHA Enterprise uses two different keys — and confusing them is one of the most common configuration mistakes. The site key renders the CAPTCHA widget on the page. The API key authenticates server-side verification requests to Google. You need the site key when sending tasks to CaptchaAI, not the API key.

The Two Keys Explained

Site Key (Public)

The site key is embedded in the page HTML. It identifies which reCAPTCHA configuration to load:

<script src="https://www.google.com/recaptcha/enterprise.js?render=6LcR_RsTAAAAADge..."></script>

Or in a grecaptcha.enterprise.execute call:

grecaptcha.enterprise.execute('6LcR_RsTAAAAADge...', { action: 'login' });

Properties:

  • Starts with 6L (same prefix as standard reCAPTCHA)
  • Visible in page source — public by design
  • Tied to specific domains in Google Cloud Console
  • This is what CaptchaAI needs to solve the challenge

API Key (Private)

The API key authenticates server-to-Google communication for token verification:

POST https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/assessments?key=AIzaSy...

Properties:

  • Starts with AIzaSy (Google Cloud API key format)
  • Never exposed in client-side code
  • Used only by the site's backend to verify tokens
  • CaptchaAI does not need this key

Key Comparison

Property Site Key API Key
Format 6L... (40 chars) AIzaSy... (39 chars)
Visibility Public (in HTML/JS) Private (server-side only)
Purpose Load CAPTCHA widget Verify tokens with Google
Where found Page source, JS calls Server config, env vars
CaptchaAI needs? Yes No

reCAPTCHA Enterprise vs Standard

reCAPTCHA Enterprise differs from the free version in how keys work:

Feature Standard (free) Enterprise
Site key source reCAPTCHA admin console Google Cloud Console
Verification endpoint siteverify assessments
Auth for verification Secret key (shared secret) API key or service account
Score response score field (0.0–1.0) riskAnalysis.score + reasons
CaptchaAI task type RecaptchaV2Task / RecaptchaV3Task RecaptchaV2EnterpriseTask / RecaptchaV3EnterpriseTask

Finding the Site Key

Search the HTML for enterprise.js:

View Source → Ctrl+F → "enterprise.js"

The render parameter contains the site key:

<script src="https://www.google.com/recaptcha/enterprise.js?render=6LcR_RsTAAAAADge..."></script>

Method 2: JavaScript Console

Run in the browser console:

// Check for Enterprise grecaptcha
if (window.grecaptcha && window.grecaptcha.enterprise) {
  console.log('reCAPTCHA Enterprise detected');
}

// Find site key from rendered widgets
document.querySelectorAll('[data-sitekey]').forEach(el => {
  console.log('Site key:', el.getAttribute('data-sitekey'));
});

Method 3: Network Tab

Filter network requests for enterprise.js or recaptcha/enterprise — the site key appears in the request URL or payload.

Sending to CaptchaAI

Once you have the site key, submit it as the websiteKey parameter:

POST https://ocr.captchaai.com/in.php

Required parameters:

Parameter Value
key Your CaptchaAI API key (YOUR_API_KEY)
method userrecaptcha
googlekey The site key from the page (6LcR_Rs...)
pageurl The full URL where the CAPTCHA appears
enterprise 1 (flags this as Enterprise)

Optional Enterprise parameters:

Parameter Purpose
enterprise_type Specify v2 or v3 Enterprise
action The action name (for v3 Enterprise)
min_score Minimum score needed (for v3 Enterprise)

How Enterprise Verification Differs

Understanding the full flow helps explain why only the site key matters for solving:

  1. Browser loads enterprise.js using the site key
  2. Browser runs challenge, gets token
  3. Site backend sends token + API key to Google's assessments endpoint
  4. Google returns risk score and assessment details
  5. Site backend decides whether to accept based on score

CaptchaAI replaces steps 1–2. It generates a valid token using the site key. The site's backend then verifies that token with its own API key — CaptchaAI is not involved in verification.

Troubleshooting

Issue Cause Fix
"ERROR_WRONG_CAPTCHA_ID" Sent API key instead of site key Use the 6L... key from the page, not the AIzaSy... key
Token rejected by site Wrong Enterprise type (v2 vs v3) Set enterprise=1 and correct enterprise_type
"Invalid sitekey" Key from wrong environment (staging vs prod) Extract key from the exact target URL
No Enterprise flag Submitted as standard reCAPTCHA Add enterprise=1 to your request

FAQ

How do I tell if a site uses Enterprise or standard reCAPTCHA?

Check the script URL. Enterprise loads from /recaptcha/enterprise.js while standard uses /recaptcha/api.js. In the JavaScript, Enterprise uses grecaptcha.enterprise.execute() instead of grecaptcha.execute().

Can I use the same CaptchaAI API key for both standard and Enterprise?

Yes. Your CaptchaAI API key works for all CAPTCHA types. Set enterprise=1 in your request to indicate an Enterprise challenge — the solving is charged at the same rate.

Does the site's API key rotation affect my solving?

No. The API key is only used for server-side verification between the site's backend and Google. It has no impact on token generation or CaptchaAI's solving process.

Next Steps

Solve reCAPTCHA Enterprise challenges — get your CaptchaAI API key and submit the site key with the enterprise=1 flag.

Discussions (0)

No comments yet.

Related Posts

Comparisons WebDriver vs Chrome DevTools Protocol for CAPTCHA Automation
Compare Web Driver and Chrome Dev Tools Protocol (CDP) for CAPTCHA automation — detection, performance, capabilities, and when to use each with Captcha AI.

Compare Web Driver and Chrome Dev Tools Protocol (CDP) for CAPTCHA automation — detection, performance, capabi...

Automation Python reCAPTCHA v2
Mar 27, 2026
Comparisons Free vs Paid CAPTCHA Solvers: What You Need to Know
Compare free and paid CAPTCHA solving tools — browser extensions, open-source solvers, and API services — covering reliability, speed, type support, and cost.

Compare free and paid CAPTCHA solving tools — browser extensions, open-source solvers, and API services — cove...

Automation All CAPTCHA Types Migration
Jan 23, 2026
Comparisons reCAPTCHA v2 vs v3 Explained
Compare re CAPTCHA v 2 and v 3 side by side.

Compare re CAPTCHA v 2 and v 3 side by side. Learn how each version works, their detection methods, and how to...

Automation reCAPTCHA v3 Migration
Mar 19, 2026
Comparisons Headless vs Headed Chrome for CAPTCHA Solving
Compare headless and headed Chrome for CAPTCHA automation — detection differences, performance trade-offs, and when to use each mode with Captcha AI.

Compare headless and headed Chrome for CAPTCHA automation — detection differences, performance trade-offs, and...

Automation Python reCAPTCHA v2
Mar 09, 2026
Comparisons GeeTest vs reCAPTCHA
Compare Gee Test and re CAPTCHA side by side.

Compare Gee Test and re CAPTCHA side by side. Learn about challenge types, detection methods, solving approach...

Automation Testing reCAPTCHA v3
Apr 01, 2026
Comparisons Cloudflare Managed Challenge vs Interactive Challenge
Understand the difference between Cloudflare's Managed Challenge and Interactive Challenge, how each works, and the best approach for solving them.

Understand the difference between Cloudflare's Managed Challenge and Interactive Challenge, how each works, an...

Automation Migration Cloudflare Challenge
Mar 31, 2026
Comparisons BLS CAPTCHA vs reCAPTCHA Grid — Comparison
Compare BLS CAPTCHA and re CAPTCHA grid challenges.

Compare BLS CAPTCHA and re CAPTCHA grid challenges. Learn the differences in format, solving approach, and Cap...

Automation Migration BLS CAPTCHA
Feb 12, 2026
Comparisons Migrate from Anti-Captcha to CaptchaAI Step by Step
Step-by-step guide to migrate from Anti-Captcha's custom JSON API to Captcha AI's 2 Captcha-compatible format.

Step-by-step guide to migrate from Anti-Captcha's custom JSON API to Captcha AI's 2 Captcha-compatible format....

Automation Python All CAPTCHA Types
Mar 16, 2026
Comparisons CaptchaAI vs DeathByCaptcha: Full Comparison
Compare Captcha AI and Death By Captcha on pricing, speed, CAPTCHA type coverage, API design, and modern feature support.

Compare Captcha AI and Death By Captcha on pricing, speed, CAPTCHA type coverage, API design, and modern featu...

Automation All CAPTCHA Types Migration
Mar 22, 2026
Explainers How BLS CAPTCHA Works: Grid Logic and Image Selection
Deep dive into BLS CAPTCHA grid logic — how images are arranged, how instructions map to selections, and how Captcha AI processes BLS challenges.

Deep dive into BLS CAPTCHA grid logic — how images are arranged, how instructions map to selections, and how C...

Automation BLS CAPTCHA
Apr 09, 2026
Explainers Browser Fingerprinting and CAPTCHA: How Detection Works
How browser fingerprinting affects CAPTCHA challenges, what signals trigger CAPTCHAs, and how to reduce detection with Captcha AI.

How browser fingerprinting affects CAPTCHA challenges, what signals trigger CAPTCHAs, and how to reduce detect...

reCAPTCHA v2 Cloudflare Turnstile reCAPTCHA v3
Mar 23, 2026
Explainers GeeTest v3 Challenge-Response Workflow: Technical Deep Dive
A technical deep dive into Gee Test v 3's challenge-response workflow — the registration API, challenge token exchange, slider verification, and how Captcha AI...

A technical deep dive into Gee Test v 3's challenge-response workflow — the registration API, challenge token...

Automation Testing GeeTest v3
Mar 02, 2026