Betalen per oplossing · API

reCAPTCHA v3 oplossen

CapMonster Cloud is een dienst voor het automatisch oplossen van reCAPTCHA v3 via een API. Geef de minimumscore (minScore) op, ontvang een gebruiksklaar token en zet je automatisering voort zonder handmatige handelingen.

Gratis testen: $0.10 testsaldo ↓

API-responstijd

≤ 2 s

Succespercentage

tot 99%

per 1000 tokens

$ 0.90

Prijzen voor de reCAPTCHA v3 Solver

Bericht	Prijs (USD)	Succes
reCAPTCHA v3 99%	$ 0.90 1000 tokens	99%

Wat is Google reCAPTCHA v3

reCAPTCHA v3 is een onzichtbare beveiliging van Google die echte gebruikers van bots onderscheidt zonder de controle “Ik ben geen robot”. Op de pagina draait een verborgen script dat het gedrag van de bezoeker analyseert en een vertrouwensscore (score) van 0,0 tot 1,0 teruggeeft. De ontwikkelaar stelt een drempel in; als de score daaronder komt, kan extra controle of blokkering vereist zijn. Zo wordt beveiliging geboden zonder extra handelingen voor de gebruiker.

1. Verborgen script

Een script dat met de site key wordt geladen, draait op de achtergrond van elke pagina die het gebruikt. De bezoeker ziet geen selectievakje en hoeft niets te doen.

2. Trust score

Op basis van verzamelde gedragsgegevens geeft Google de bezoeker een score die aangeeft hoe waarschijnlijk het een mens is. De site-eigenaar kiest de drempel.

3. Serverdrempel

De site vergelijkt de score met de eigen drempel. Daaronder kan de site extra verificatie vragen of het verzoek blokkeren.

reCAPTCHA v3-verificatieworkflow

Stap 1. Script laadt

De pagina laadt het reCAPTCHA v3-script met de site key en roept grecaptcha.execute aan voor een actie.

Stap 2. Token uitgegeven

Google geeft een token voor die actie terug.

Stap 3. Token naar de backend

De pagina stuurt het token met de formuliergegevens naar de server. Het token is ongeveer 2 minuten geldig.

Stap 4. Siteverify

De server stuurt de geheime sleutel en het token naar het siteverify-eindpunt van Google.

Stap 5. Score- en actiecontrole

De server controleert dat success true is, dat de score de drempel haalt en dat de action overeenkomt. Een geldig token met een lage score kan alsnog worden afgewezen.

reCAPTCHA v3-score: wat het betekent en hoe je minScore instelt

reCAPTCHA v3-scores lopen van 0.0 (waarschijnlijk bot) tot 1.0 (waarschijnlijk mens). Google adviseert een drempel van 0.5. Observeer eerst echt verkeer voordat je deze afdwingt of aanpast.

Google ondersteunt 11 scoreniveaus. Gratis Essentials geeft 0.1, 0.3, 0.7 en 0.9 terug; met facturering ontgrendel je alle niveaus en reason codes. Scores in staging en de eerste week kunnen afwijken van productie.

De CapMonster Cloud-parameter minScore (0.1–0.9) stelt de minimale tokenscore in. Stem af op de drempel van de site; hoge waarden zoals 0.9 verhogen mislukte pogingen.

pageAction moet overeenkomen met de action in grecaptcha.execute. Gebruik alleen letters, cijfers, slashes en underscores. Sites kunnen afwijkingen weigeren. Geef zowel minScore als pageAction door.

Scorebereik

0.0–1.0

Standaarddrempel

0.5

minScore

0.1–0.9

reCAPTCHA v3-scoretest: score controleren

Een scoretest vereist een backend: de score komt in de siteverify-respons.

1. Gebruik op een testpagina je site key en roep grecaptcha.execute aan met een action.
2. Stuur token en geheime sleutel vanaf je backend naar https://www.google.com/recaptcha/api/siteverify.
3. Vergelijk de teruggegeven score met je drempel en controleer de action.

Probeer onze reCAPTCHA v3-demopagina zonder zelf een testpagina te bouwen.

reCAPTCHA v3-solvers vergeleken

De tabel toont prijs, API-responstijd en succespercentage voor vier reCAPTCHA v3-oplosservices.

Parameter	CapMonster Cloud	2Captcha	CapSolver	DeathByCaptcha
Prijs per 1000 oplossingen (vanaf)	$ 0.90	$1.45	$1.00	$2.89
API-responstijd	≤ 2 s	≤ 2 s	< 3 s	≤ 3 s
Succespercentage	tot 99%	~77–92%	~95–98%	~64–90%

Disclaimer: 2Captcha, CapSolver en DeathByCaptcha zijn handelsmerken van hun respectieve eigenaren. CapMonster Cloud is niet gelieerd aan deze entiteiten. Prestatiemetingen en prijsvergelijkingen zijn gebaseerd op openbaar beschikbare gegevens en interne benchmarks van 27.09.2026.

Gratis testen

$0.10

Nieuwe gebruikers krijgen $0.10 testsaldo om CapMonster Cloud te proberen.

1. Registreer je bij CapMonster Cloud.
2. Stuur een bericht naar support via de livechat of support@capmonster.cloud met het e-mailadres van je account.

Hoe reCAPTCHA v3 op te lossen via CapMonster Cloud

CapMonster Cloud ontvangt captcha-parameters, verwerkt ze op zijn servers en retourneert een kant-en-klaar token. Voeg dit token in het formulier in om de controle zonder gebruikersinteractie te passeren. De taak RecaptchaV3TaskProxyless draait op de eigen proxyservers van CapMonster Cloud, dus je geeft geen proxyparameters door.

Jouw script

CapMonster Cloud API

Doelsite

Taak aanmaken

In deze stap verstrekt u uw API-sleutel, het type captcha en de parameters. De dienst retourneert een unieke taskId waarmee u later het resultaat kunt ophalen.

API-aanvraag versturen

In het verzoek om reCAPTCHA v3 op te lossen moet je de volgende parameters opgeven:

Parameter	Beschrijving
type `string`Verplicht	`RecaptchaV3TaskProxyless`
websiteURL `string`Verplicht	het adres van de pagina waarop de captcha wordt opgelost
websiteKey `string`Verplicht	de sleutelidentifier (sitekey) die is opgegeven op de pagina van je site met de captcha `https://www.google.com/recaptcha/api.js?render=SITE_KEY` `6Le0xVgUAAAAAIt20XEB4rVhYOODgTl00d8juDob`
isEnterprise `boolean`Optioneel	Voor reCAPTCHA v3 Enterprise zet je `isEnterprise: true` in `RecaptchaV3TaskProxyless` (true/false of 1/0). CapMonster Cloud verwerkt dit als `RecaptchaV3EnterpriseTask`.
minScore `double`Optioneel	kan een waarde hebben van 0.1 tot 0.9
pageAction `string`Optioneel	de waarde van de parameter action die wordt doorgegeven door de ReCaptcha-widget in Google. Standaardwaarde: verify `grecaptcha.execute('site_key', {action: 'login_test'})`

Meer informatie over de parameters en hoe je die automatisch verzamelt vind je in de CapMonster Cloud documentatie.

Endpoint voor het versturen van de taak:

text

https://api.capmonster.cloud/createTask

Voorbeeldrequest:

json

{
  "clientKey": "API_KEY",
  "task": {
    "type": "RecaptchaV3TaskProxyless",
    "websiteURL": "https://lessons.zennolab.com/captchas/recaptcha/v3.php?level=beta",
    "websiteKey": "6Le0xVgUAAAAAIt20XEB4rVhYOODgTl00d8juDob",
    "minScore": 0.3,
    "pageAction": "myverify"
  }
}

Respons:

json

{
  "errorId":0,
  "taskId":407533072
}

Resultaat ontvangen

Controleer na het aanmaken van de taak regelmatig de status.

Adres voor het ontvangen van het resultaat:

text

https://api.capmonster.cloud/getTaskResult

Voorbeeldrequest:

json

{
  "clientKey":"API_KEY",
  "taskId": 407533072
}

Respons:

json

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "gRecaptchaResponse": "3AHJ_VuvYIBNBW5yyv0zRYJ75VkOKv…hKj9_xGBJKnQimF72rfoq3Iy-DyGHMwLAo6a3"
  }
}

Antwoord met userAgent

json

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/155.0.0.0 Safari/537.36",
    "gRecaptchaResponse": "0cAFcWeA5Y3...hF8UWA",
    "cookies": {
      "nocookies": "true"
    }
  }
}

BELANGRIJK

Op sommige sites bevat de oplossing ook userAgent. Gebruik deze UserAgent bij het verzenden van het token of bevestigen van de oplossing, ook als deze afwijkt van die van uw browser of script.

Token op de pagina plaatsen

De verkregen token (de waarde "gRecaptchaResponse") kan in een verborgen formulierveld worden geplaatst of worden gebruikt om een JS-functie op de site aan te roepen om de oplossing te bevestigen. Daarna accepteert de server het formulier als correct ingevuld. Voor automatisering en testen is het handig om Puppeteer, Selenium of Playwright te gebruiken; deze tools kunnen gebruikersacties simuleren, tokens invoegen en formulieren verzenden.

Op sommige sites bevat de oplossing ook userAgent. Gebruik deze UserAgent bij het verzenden van het token of bevestigen van de oplossing, ook als deze afwijkt van die van uw browser of script.

Probeer het op de demopagina

Hoe je de sitekey en pageAction vindt

Een reCAPTCHA v3-taak heeft de site key (websiteKey) en de action-naam (pageAction) nodig.

1. Klik met de rechtermuisknop op de pagina en kies Inspect.
2. Zoek in Elements of Network naar api.js?render=SITE_KEY. De waarde na render= is websiteKey. reCAPTCHA Enterprise gebruikt enterprise.js?render=SITE_KEY.
3. Zoek grecaptcha.execute('SITE_KEY', {action: 'ACTION'}). ACTION is pageAction. Enterprise gebruikt grecaptcha.enterprise.execute. Indien weggelaten, gebruikt de taak standaard verify.
4. Vang grecaptcha.execute af in een headless browser zoals Playwright om beide waarden te verzamelen. Zie JavaScript-, Python- en C#-voorbeelden in de CapMonster Cloud-documentatie.

Sommige parameters worden bij elke keer dat de pagina wordt geladen opnieuw gegenereerd. Los de taak daarom op zodra je ze hebt verzameld.

reCAPTCHA v3 Solver SDK’s: Python, Node.js, C#

CapMonster Cloud biedt kant-en-klare libraries voor gebruik met Python, JavaScript (Node.js) en C#.

Python

JavaScript

python
import asyncio
from capmonstercloudclient import CapMonsterClient, ClientOptions
from capmonstercloudclient.requests import RecaptchaV3ProxylessRequest
client_options = ClientOptions(api_key="YOUR_API_KEY")  # Vul uw CapMonster Cloud API-sleutel in
cap_monster_client = CapMonsterClient(options=client_options)
# Indien nodig kunt u het saldo controleren
balance = asyncio.run(cap_monster_client.get_balance())
print("Balance:", balance)
recaptcha_v3_request = RecaptchaV3ProxylessRequest(
    websiteUrl="https://lessons.zennolab.com/captchas/recaptcha/v3.php?level=beta",  # URL van uw pagina met de captcha
    websiteKey="6Le0xVgUAAAAAIt20XEB4rVhYOODgTl00d8juDob",  # Vervang door een geldige waarde
    minScore=0.7,  # Minimale vertrouwensdrempel (score)
    pageAction="myverify"  # Actie op de pagina
)
async def solve_captcha():
    return await cap_monster_client.solve_captcha(recaptcha_v3_request)
responses = asyncio.run(solve_captcha())
print(responses)

Python SDK

Node.js SDK

.NET SDK

U kunt captcha-oplossing ook testen met de CapMonster Cloud-browserextensie voor Chrome en Firefox.

Waarvoor teams een reCAPTCHA v3-solver gebruiken

QA en end-to-end-tests

Draai signup-, checkout- en formulierflows in CI/CD met Playwright, Puppeteer of Selenium op pagina’s die van jou zijn of die je mag testen.

Monitoring

Controleer of beschermde formulieren en endpoints blijven werken na releases en drempelwijzigingen.

Openbaar beschikbare data

Verzamel openbaar beschikbare data van open pagina’s met score-gebaseerde controles.

Toegankelijkheid

Ondersteun geautomatiseerde assistieve workflows op sites met onzichtbare botcontroles.

AI-agents

Laat een agent via MCP een token aanvragen wanneer een workflow een captcha bereikt.

Alleen legitiem gebruik

Gebruik CapMonster Cloud voor openbare data en op sites die van jou zijn of die je mag testen. Data van derden achter login of paywall verzamelen zonder toestemming is verboden.

reCAPTCHA v3 en reCAPTCHA v3 Enterprise

Essentials4 niveaus

0.1 · 0.3 · 0.7 · 0.9

reCAPTCHA Enterprise gebruikt score-gebaseerde controles: Essentials geeft vier niveaus terug.

Premium · Enterprise11 niveaus

Redenen voor de toegekende risicoscore

Premium en Enterprise geven 11 terug, met basis- en geavanceerde explainability-redenen.

RecaptchaV3TaskProxylessisEnterprise: true

Voor reCAPTCHA v3 Enterprise zet je isEnterprise: true in RecaptchaV3TaskProxyless (true/false of 1/0). CapMonster Cloud verwerkt dit als RecaptchaV3EnterpriseTask.

Nuttige materialen

reCAPTCHA v3 Enterprise-taak (docs) (EN)reCAPTCHA v2 vs v3 vs Enterprise (blog) (EN)isEnterprise-ondersteuning (blog) (EN)

Een reCAPTCHA v3-token op je eigen site verifiëren

POST https://www.google.com/recaptcha/api/siteverify

secret=YOUR_SECRET_KEY
response=TOKEN

Stuur op je eigen site secret en response naar https://www.google.com/recaptcha/api/siteverify. Tokens verlopen na 2 minuten en werken één keer. Controleer success, score en action; Google adviseert een drempel van 0.5.

Zie Captcha API (Google reCAPTCHA v3) voor Node.js- en Python-voorbeelden, foutafhandeling en score-gebaseerde acties.

reCAPTCHA v3-fouten en hoe u ze oplost

Onjuiste site of sleutel

Captcha wordt niet geladen of geeft invalid-input-secret terug.

Time-out bij oplossen

De server heeft het antwoord niet op tijd ontvangen, verhoog de wachttijd.

Lege token

Fout bij het doorgeven van het resultaat aan de pagina.

Antwoord success=false

De token is verlopen, opnieuw gebruikt of vervalst. Schakel voor diagnose de logging van verzoeken in en controleer het veld error-codes in het antwoord van Google.

Lage score (bijv. <0.5)

Kan tot weigering leiden, zelfs bij success=true, omdat Google het vertrouwen in de gebruiker op basis van de score beoordeelt.

Controleer de action

Om zeker te zijn dat de token voor de juiste actie op de pagina is bedoeld

Google siteverify-foutcodes

siteverify · response

{
  "success": false,
  "error-codes": [
    "timeout-or-duplicate"
  ]
}

Bij een fout geeft Google een error-codes-array terug

secretSecret key

missing-input-secret

De parameter secret ontbreekt

secretSecret key

invalid-input-secret

De parameter secret is ongeldig of onjuist opgemaakt

responseToken

missing-input-response

Het token ontbreekt

responseToken

invalid-input-response

Het token is ongeldig of onjuist opgemaakt

requestRequest

bad-request

Het verzoek is ongeldig of onjuist opgemaakt

responseTokenlevensduur

timeout-or-duplicate

Het token is te oud of is al gebruikt

Andere captcha’s die CapMonster Cloud oplost

Nuttige links

Documentatie reCAPTCHA v3 (EN) →

Documentatie reCAPTCHA v3 Enterprise (EN) →

Hoe ReCaptcha v3 in Python op te lossen met Selenium & CapMonster Cloud (EN) →

Hoe ReCaptcha v3 in JavaScript op te lossen met Selenium & CapMonster Cloud (EN) →

Hoe ReCaptcha v3 in C# op te lossen met Selenium & CapMonster Cloud (EN) →

Captcha API (Google reCAPTCHA v3): documentatie en integratiehandleiding voor ontwikkelaars (EN) →

Veelgestelde vragen over reCAPTCHA v3

Welke minScore-waarde moet ik instellen voor een reCAPTCHA v3-taak?

De parameter minScore accepteert waarden van 0.1 tot 0.9 en vertelt CapMonster Cloud welke minimale trust score het geretourneerde token moet hebben. 0.3 is een redelijk startpunt. Een te hoge waarde (bijv. 0.9) vergroot de kans op oplossingsfouten; een te lage waarde kan tokens teruggeven met een score die je serverdrempel toch zou afwijzen. Stem de waarde af op de werkelijke afwijzingspercentages in je testomgeving.

Hoe vind ik de sitekey en action voor een reCAPTCHA v3-taak?

Open de pagina en zoek met de inspecteur naar api.js?render=SITE_KEY. De waarde na render= is de sitekey. De action staat in grecaptcha.execute(siteKey, {action: "..."}). U kunt deze aanroep automatisch vastleggen met Playwright. Sommige waarden veranderen bij het laden; maak de taak direct na het verzamelen aan. Bekijk alle stappen.

Wat is een goede reCAPTCHA v3-score?

1.0 duidt zeer waarschijnlijk op een legitieme interactie en 0.0 op een bot. Google adviseert 0.5 als standaarddrempel. Een goede score hangt af van de drempel van de website. Stel minScore daarop in en pas de waarde aan het werkelijke verkeer aan. Zo controleert u een score.

Hoe lang is een reCAPTCHA v3-token geldig na uitgifte?

Een token van reCAPTCHA v3 is ongeveer 2 minuten geldig. Je automatiseringspipeline moet het token binnen dat venster naar de server sturen; na verloop geeft Googles siteverify-endpoint success: false terug. Houd de oplossingsstap zo dicht mogelijk bij het formulierverzenden en cache geen tokens tussen verzoeken.

Een token kan slechts eenmaal worden geverifieerd. Een verlopen of al gebruikt token veroorzaakt timeout-or-duplicate. Vraag voor elke inzending een nieuw token aan.

Hoe injecteer je een reCAPTCHA v3-token met Playwright, Puppeteer of Selenium?

Om een reCAPTCHA v3-token te injecteren, zoek je het verborgen antwoordveld (meestal een textarea of input met ID g-recaptcha-response) en voeg je het token in dat je van je CAPTCHA-oplossingsservice hebt gekregen. Zo doe je dat in de drie automatiseringsframeworks.

Playwright / Puppeteer (Node.js)

javascript

const token = "YOUR_TOKEN";
await page.evaluate((t) => {
  document.getElementById('g-recaptcha-response').value = t;
}, token);
await page.click('#submit-btn');

Selenium (Python)

python

token = "YOUR_TOKEN"
driver.execute_script(f"document.getElementById('g-recaptcha-response').value = '{token}';")
driver.find_element("id", "submit-btn").click()

Sommige websites gebruiken callback-functies om het token te valideren. Als het formulier niet wordt verzonden, zoek dan de functienaam via de console (___grecaptcha_cfg.clients) en roep die handmatig aan:

javascript

await page.evaluate((t) => {
  window.onSuccessCallback(t);
}, token);

Waarom geeft reCAPTCHA v3 success=true terug maar wordt mijn verzoek toch afgewezen?

Een success: true-antwoord van Google betekent alleen dat het token geldig is. Je backend kan het verzoek nog steeds afwijzen als de tokenscore onder je geconfigureerde drempel ligt.

Een ander veelvoorkomend probleem is een action-mismatch. Het token moet worden geverifieerd met dezelfde action-waarde die bij het aanmaken van de taak is gebruikt.

Voor diagnose:

controleer het veld score in het siteverify-antwoord;
verifieer dat de action-waarde overeenkomt;
inspecteer error-codes wanneer success false is.

Is success true, dan is de error-codes-array meestal leeg — score en action zijn dan de belangrijkste velden om te controleren.

Lost CapMonster Cloud reCAPTCHA v3 Enterprise op?

Ja. Voeg isEnterprise: true toe aan de reCAPTCHA v3-taak (toegestane waarden: true/false of 1/0). De verwerking is gelijk aan RecaptchaV3EnterpriseTask. Zie het gedeelte hierboven en de API-documentatie.

Geen enkel hulpmiddel kan een slagingspercentage van 100% garanderen bij veranderende beveiliging, maar CapMonster Cloud behaalt een hoog slagingspercentage voor reCAPTCHA v3. Dit is gebaseerd op interne maandelijkse benchmarks van het CapMonster Cloud-team. De werkelijke API-responstijd en het slagingspercentage variëren afhankelijk van de doelwebsite, serverbelasting en netwerkomstandigheden.

reCAPTCHA is een handelsmerk van Google LLC. CapMonster Cloud is niet verbonden met of goedgekeurd door Google. De dienst is bedoeld voor openbaar beschikbare gegevens, het testen van eigen of geautoriseerde websites, beeldherkenning en toegankelijkheid. Het zonder toestemming verzamelen van gegevens van derden achter een aanmelding of betaalmuur is verboden; uw eigen accounts vallen hier niet onder. U bepaalt de juridische status van uw gegevens voordat u begint.