Pagamento por resolução · API
1. Script oculto
Um script carregado com a chave do site corre em segundo plano em cada página que o utiliza. O visitante não vê nenhuma caixa de seleção e não realiza nenhuma ação.
Um script carregado com a chave do site corre em segundo plano em cada página que o utiliza. O visitante não vê nenhuma caixa de seleção e não realiza nenhuma ação.
Com base nos dados de comportamento recolhidos, a Google atribui ao visitante uma pontuação que indica a probabilidade de ser humano. O proprietário do site escolhe o limiar.
O site compara a pontuação com o seu próprio limiar. Abaixo dele, o site pode pedir verificação adicional ou bloquear o pedido.
grecaptcha.execute para uma ação.success é true, que o score cumpre o limiar e que a action corresponde. Um token válido com score baixo ainda pode ser rejeitado.Os scores reCAPTCHA v3 vão de 0.0 (provável bot) a 1.0 (provável humano). A Google sugere um limiar de 0.5. Observe o tráfego real antes de aplicar ou ajustar.
A Google suporta 11 níveis de score. O Essentials gratuito devolve 0.1, 0.3, 0.7 e 0.9; com faturação desbloqueiam-se todos os níveis e reason codes. Scores em staging e na primeira semana podem diferir da produção.
O parâmetro CapMonster Cloud minScore (0.1–0.9) define o score mínimo do token. Alinhe-o ao limiar do site; valores altos como 0.9 aumentam falhas.
pageAction deve corresponder à action em grecaptcha.execute. Use apenas letras, dígitos, barras e underscores. Os sites podem rejeitar discrepâncias. Passe minScore e pageAction.
Um teste de score exige backend: o score chega na resposta siteverify.
1. Numa página de teste, use a site key e chame grecaptcha.execute com uma action.
2. Envie o token e a chave secreta do backend para https://www.google.com/recaptcha/api/siteverify.
3. Compare o score devolvido com o limiar e verifique a action.
Experimente a nossa página demo reCAPTCHA v3 sem criar uma página de teste.
A tabela indica preço, tempo de resposta da API e taxa de sucesso de quatro serviços de resolução reCAPTCHA v3.
| Parâmetro | CapMonster Cloud | 2Captcha | CapSolver | DeathByCaptcha |
|---|---|---|---|---|
Preço por 1000 resoluções (a partir de) | $ 0.90 | $1.45 | $1.00 | $2.89 |
Tempo de resposta da API | ≤ 2 s | ≤ 2 s | < 3 s | ≤ 3 s |
Taxa de sucesso | até 99% | ~77–92% | ~95–98% | ~64–90% |
Aviso: 2Captcha, CapSolver e DeathByCaptcha são marcas dos respetivos proprietários. A CapMonster Cloud não está afiliada a estas entidades. As métricas de desempenho e a comparação de preços baseiam-se em dados públicos e benchmarks internos de 28.09.2026.
$0.10
Novos utilizadores recebem $0.10 de saldo de teste para experimentar o CapMonster Cloud.
1. Registe-se em CapMonster Cloud.
2. Contacte o suporte via chat ao vivo ou support@capmonster.cloud com o email da sua conta.
O CapMonster Cloud aceita os parâmetros da captcha, processa-os nos seus servidores e devolve um token pronto a usar. Insira este token no formulário para passar a verificação sem interação do utilizador. A tarefa RecaptchaV3TaskProxyless corre nos servidores proxy do CapMonster Cloud, por isso não passa parâmetros de proxy.
Nesta etapa, envia a sua chave de API, o tipo de captcha e os respetivos parâmetros. O serviço devolve um taskId único, através do qual poderá obter o resultado posteriormente.
No pedido para resolver o reCAPTCHA v3 é necessário indicar os seguintes parâmetros:
| Parâmetro | Descrição |
|---|---|
typestringObrigatório | RecaptchaV3TaskProxyless |
websiteURLstringObrigatório | o endereço da página em que o captcha é resolvido |
websiteKeystringObrigatório | a chave identificadora (sitekey) indicada na página do seu site com o captcha https://www.google.com/recaptcha/api.js?render=SITE_KEY6Le0xVgUAAAAAIt20XEB4rVhYOODgTl00d8juDob |
isEnterprisebooleanOpcional | Para reCAPTCHA v3 Enterprise, defina isEnterprise: true em RecaptchaV3TaskProxyless (true/false ou 1/0). O CapMonster Cloud processa como RecaptchaV3EnterpriseTask. |
minScoredoubleOpcional | pode ter um valor de 0.1 a 0.9 |
pageActionstringOpcional | o valor do parâmetro action que é enviado pelo widget ReCaptcha no Google. Valor predefinido: verify grecaptcha.execute('site_key', {action: 'login_test'}) |
https://api.capmonster.cloud/createTask{
"clientKey": "API_KEY",
"task": {
"type": "RecaptchaV3TaskProxyless",
"websiteURL": "https://lessons.zennolab.com/captchas/recaptcha/v3.php?level=beta",
"websiteKey": "6Le0xVgUAAAAAIt20XEB4rVhYOODgTl00d8juDob",
"minScore": 0.3,
"pageAction": "myverify"
}
}
{
"errorId":0,
"taskId":407533072
}
https://api.capmonster.cloud/getTaskResult{
"clientKey":"API_KEY",
"taskId": 407533072
}
{
"errorId": 0,
"status": "ready",
"solution": {
"gRecaptchaResponse": "3AHJ_VuvYIBNBW5yyv0zRYJ75VkOKv…hKj9_xGBJKnQimF72rfoq3Iy-DyGHMwLAo6a3"
}
}
{
"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"
}
}
}userAgent. Use esse UserAgent ao enviar o token ou confirmar a solução, mesmo que seja diferente do utilizado pelo navegador ou script.userAgent. Use esse UserAgent ao enviar o token ou confirmar a solução, mesmo que seja diferente do utilizado pelo navegador ou script.Uma tarefa reCAPTCHA v3 precisa da chave do site (websiteKey) e do nome da ação (pageAction).
1. Clique com o botão direito na página e selecione Inspect.
2. Em Elements ou Network, encontre api.js?render=SITE_KEY. O valor após render= é websiteKey. reCAPTCHA Enterprise usa enterprise.js?render=SITE_KEY.
3. Encontre grecaptcha.execute('SITE_KEY', {action: 'ACTION'}). ACTION é pageAction. Enterprise usa grecaptcha.enterprise.execute. Se omitido, a tarefa usa verify por predefinição.
4. Capture grecaptcha.execute num browser headless como Playwright para obter ambos os valores. Veja exemplos em JavaScript, Python e C# na documentação CapMonster Cloud.
import asyncio
from capmonstercloudclient import CapMonsterClient, ClientOptions
from capmonstercloudclient.requests import RecaptchaV3ProxylessRequest
client_options = ClientOptions(api_key="YOUR_API_KEY") # Indique a sua chave de API do CapMonster Cloud
cap_monster_client = CapMonsterClient(options=client_options)
# Se necessário, pode verificar o saldo
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 da sua página com o captcha
websiteKey="6Le0xVgUAAAAAIt20XEB4rVhYOODgTl00d8juDob", # Substitua por um valor correto
minScore=0.7, # Limite mínimo da pontuação de confiança
pageAction="myverify" # Ação na página
)
async def solve_captcha():
return await cap_monster_client.solve_captcha(recaptcha_v3_request)
responses = asyncio.run(solve_captcha())
print(responses)Execute fluxos de registo, checkout e formulários em CI/CD com Playwright, Puppeteer ou Selenium em páginas suas ou autorizadas para testes.
Verifique se formulários e endpoints protegidos continuam a funcionar após releases e alterações de limiar.
Recolha dados públicos de páginas abertas com verificações baseadas em score.
Suporte fluxos assistivos automatizados em sites com verificações invisíveis de bots.
Um agente pode pedir um token via MCP quando o fluxo chega a um captcha.
Use o CapMonster Cloud para dados públicos e em sites seus ou autorizados. Recolher dados de terceiros atrás de login ou paywall sem permissão é proibido.
O reCAPTCHA Enterprise usa verificações baseadas em score: Essentials devolve quatro níveis.
Premium e Enterprise devolvem 11, com razões de explicabilidade básicas e avançadas respetivamente.
Para reCAPTCHA v3 Enterprise, defina isEnterprise: true em RecaptchaV3TaskProxyless (true/false ou 1/0). O CapMonster Cloud processa como RecaptchaV3EnterpriseTask.
POST https://www.google.com/recaptcha/api/siteverify secret=YOUR_SECRET_KEY response=TOKEN
No seu site, envie secret e response para https://www.google.com/recaptcha/api/siteverify. Os tokens expiram em 2 minutos e funcionam uma vez. Verifique success, score e action; a Google sugere um limiar de 0.5.
Veja Captcha API (Google reCAPTCHA v3) para exemplos em Node.js e Python, tratamento de erros e ações baseadas em score.
Python SDK
secretSecret keymissing-input-secretO parâmetro secret está em falta
secretSecret keyinvalid-input-secretO parâmetro secret é inválido ou está malformado
responseTokenmissing-input-responseO token está em falta
responseTokeninvalid-input-responseO token é inválido ou está malformado
requestRequestbad-requestO pedido é inválido ou está malformado
responseValidade do tokentimeout-or-duplicateO token é demasiado antigo ou já foi utilizado
reCAPTCHA v2reCAPTCHA v3· atualreCAPTCHA v2 EnterprisereCAPTCHA v3 Enterprise
GeeTest
Cloudflare TurnstileCloudflare Bot Challenge
DataDome
Tencent CAPTCHA
Amazon Waf
Faucet Pay
Imperva (Incapsula)
Prosopo
Text CAPTCHA
BinanceComplexImageTask Recaptcha
ComplexImageTask RecognitionreCAPTCHA Enterprise (Spotify, Yahoo)
Yidun
MTCaptcha
Altcha
Funcaptcha
TSPD
Hunt
Alibaba
Friendly
Documentação do reCAPTCHA v3 (EN) →Documentação do reCAPTCHA v3 Enterprise (EN) →Como resolver o ReCaptcha v3 em Python usando Selenium & CapMonster Cloud (EN) →Como resolver o ReCaptcha v3 em JavaScript usando Selenium & CapMonster Cloud (EN) →Como resolver o ReCaptcha v3 em C# usando Selenium & CapMonster Cloud (EN) →Captcha API (Google reCAPTCHA v3): documentação e guia de integração para programadores (EN) →O parâmetro minScore aceita valores de 0.1 a 0.9 e indica ao CapMonster Cloud a pontuação de confiança mínima que o token devolvido deve ter. 0.3 é um ponto de partida razoável. Um valor demasiado alto (ex.: 0.9) aumenta a probabilidade de falhas na resolução; um valor demasiado baixo pode devolver tokens com uma pontuação que o limiar do servidor deveria rejeitar de qualquer forma. Ajuste o valor com base nas taxas de rejeição reais no seu ambiente de teste.
Abra a página e procure api.js?render=SITE_KEY no inspetor. O valor após render= é o sitekey. A action consta da chamada grecaptcha.execute(siteKey, {action: "..."}). Pode capturar a chamada automaticamente com Playwright. Alguns valores mudam a cada carregamento; crie a tarefa logo após os recolher. Consulte os passos completos.
1.0 indica uma interação muito provavelmente legítima e 0.0 um provável bot. A Google sugere 0.5 como limiar predefinido. Uma boa pontuação depende do limiar do site. Defina minScore de acordo com esse limiar e ajuste-o ao tráfego real. Como verificar a pontuação.
Um token recebido do reCAPTCHA v3 é válido durante aproximadamente 2 minutos. O seu pipeline de automação deve enviar o token ao servidor dentro desse prazo; após expirar, o endpoint siteverify do Google devolve success: false. Mantenha o passo de resolução o mais próximo possível do envio do formulário e evite colocar tokens em cache entre pedidos.
Cada token só pode ser verificado uma vez. Um token expirado ou já utilizado causa timeout-or-duplicate. Solicite um novo token para cada envio.
Para injetar um token reCAPTCHA v3, encontre o campo de resposta oculto (geralmente um textarea ou input com o ID g-recaptcha-response) e insira o token obtido do serviço de resolução CAPTCHA. Eis como fazê-lo nos três frameworks de automação.
Playwright / Puppeteer (Node.js)
const token = "YOUR_TOKEN";
await page.evaluate((t) => {
document.getElementById('g-recaptcha-response').value = t;
}, token);
await page.click('#submit-btn');Selenium (Python)
token = "YOUR_TOKEN"
driver.execute_script(f"document.getElementById('g-recaptcha-response').value = '{token}';")
driver.find_element("id", "submit-btn").click()Alguns sites usam funções callback para validar o token. Se o formulário não for enviado, encontre o nome da função na consola (___grecaptcha_cfg.clients) e chame-a manualmente:
await page.evaluate((t) => {
window.onSuccessCallback(t);
}, token);Uma resposta success: true do Google significa apenas que o token é válido. O seu backend ainda pode rejeitar o pedido se a pontuação do token estiver abaixo do limiar configurado.
Outro problema comum é uma incompatibilidade de action. O token deve ser verificado com o mesmo valor action usado ao criar a tarefa.
Para diagnosticar o problema:
Se success for true, o array error-codes costuma estar vazio — score e action são os campos principais a verificar.
Sim. Inclua isEnterprise: true na tarefa reCAPTCHA v3 (valores aceites: true/false ou 1/0). É processada como RecaptchaV3EnterpriseTask. Consulte a secção acima e a documentação da API.
Nenhuma ferramenta pode garantir uma taxa de sucesso de 100% perante proteções em evolução, mas o CapMonster Cloud oferece uma elevada taxa de sucesso na resolução de reCAPTCHA v3. Os dados baseiam-se em testes comparativos internos mensais da equipa CapMonster Cloud. O tempo de resposta da API e a taxa de sucesso reais variam conforme o site de destino, a carga do servidor e as condições da rede.
reCAPTCHA é uma marca comercial da Google LLC. O CapMonster Cloud não é afiliado nem aprovado pela Google. O serviço destina-se a dados publicamente disponíveis, testes de sites próprios ou autorizados, reconhecimento de imagens e acessibilidade. É proibida a recolha sem autorização de dados de terceiros protegidos por início de sessão ou acesso pago; as suas próprias contas não são afetadas. O utilizador determina o estatuto jurídico dos seus dados antes de começar.