Pagamento por resolução · API
1. Script oculto
Um script carregado com a chave do site roda em segundo plano em cada página que o usa. 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 roda em segundo plano em cada página que o usa. O visitante não vê nenhuma caixa de seleção e não realiza nenhuma ação.
Com base nos dados de comportamento coletados, o Google atribui ao visitante uma pontuação que indica a probabilidade de ser humano. O proprietário do site escolhe o limite.
O site compara a pontuação com o próprio limite. Abaixo dele, o site pode pedir verificação adicional ou bloquear a solicitação.
grecaptcha.execute para uma ação.success é true, se o score atinge o limite e se 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). O Google sugere um limiar de 0.5. Observe o tráfego real antes de aplicar ou ajustar.
O Google oferece 11 níveis de score. O Essentials gratuito retorna 0.1, 0.3, 0.7 e 0.9; com faturamento liberam-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. Em uma 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 retornado com o limiar e verifique a action.
Experimente nossa página demo reCAPTCHA v3 sem criar uma página de teste.
A tabela lista 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 de seus respectivos proprietários. A CapMonster Cloud não é afiliada a essas entidades. As métricas de desempenho e a comparação de preços baseiam-se em dados públicos e benchmarks internos de 27.09.2026.
$0.10
Novos usuários recebem $0.10 de saldo de teste para experimentar o CapMonster Cloud.
1. Cadastre-se em CapMonster Cloud.
2. Fale com o suporte pelo chat ao vivo ou em support@capmonster.cloud informando o e-mail da sua conta.
O CapMonster Cloud aceita os parâmetros da captcha, processa-os em seus servidores e retorna um token pronto para uso. Insira este token no formulário para passar na verificação sem interação do usuário. A tarefa RecaptchaV3TaskProxyless roda nos servidores proxy do CapMonster Cloud, então você não passa parâmetros de proxy.
Nesta etapa, você envia sua chave de API, o tipo de captcha e seus parâmetros. O serviço retorna um taskId único, com o qual será possível obter o resultado depois.
Na solicitação para resolver o reCAPTCHA v3 é necessário informar 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) informada 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 padrão: 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 padrão.
4. Capture grecaptcha.execute em um navegador 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") # Informe sua chave de API do CapMonster Cloud
cap_monster_client = CapMonsterClient(options=client_options)
# Se necessário, você 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 cadastro, 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 funcionando após releases e mudanças de limiar.
Colete 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 solicitar 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. Coletar dados de terceiros atrás de login ou paywall sem permissão é proibido.
O reCAPTCHA Enterprise usa verificações baseadas em score: Essentials retorna quatro níveis.
Premium e Enterprise retornam 11, com razões de explicabilidade básicas e avançadas respectivamente.
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; o 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á ausente
secretSecret keyinvalid-input-secretO parâmetro secret é inválido ou está malformado
responseTokenmissing-input-responseO token está ausente
responseTokeninvalid-input-responseO token é inválido ou está malformado
requestRequestbad-requestA solicitação é inválida ou está malformada
responseValidade do tokentimeout-or-duplicateO token é muito antigo ou já foi usado
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 →Documentação do reCAPTCHA v3 Enterprise →Como resolver o ReCaptcha v3 em Python usando Selenium & CapMonster Cloud →Como resolver o ReCaptcha v3 em JavaScript usando Selenium & CapMonster Cloud →Como resolver o ReCaptcha v3 em C# usando Selenium & CapMonster Cloud →Captcha API (Google reCAPTCHA v3): documentação e guia de integração para desenvolvedores →O parâmetro minScore aceita valores de 0.1 a 0.9 e informa ao CapMonster Cloud a pontuação de confiança mínima que o token retornado deve ter. 0.3 é um ponto de partida razoável. Um valor muito alto (ex.: 0.9) aumenta a chance de falhas na resolução; um valor muito baixo pode retornar tokens com pontuação que seu limiar no 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 está na chamada grecaptcha.execute(siteKey, {action: "..."}). Você pode capturar a chamada automaticamente com Playwright. Alguns valores mudam a cada carregamento; crie a tarefa logo após coletá-los. Veja o passo a passo completo.
1.0 indica uma interação muito provavelmente legítima e 0.0 um provável bot. O Google sugere 0.5 como limite padrão. Uma boa pontuação depende do limite do site. Defina minScore de acordo com esse limite e ajuste-o ao tráfego real. Como verificar a pontuação.
Um token recebido do reCAPTCHA v3 é válido por aproximadamente 2 minutos. Seu pipeline de automação deve enviar o token ao servidor dentro desse prazo; após expirar, o endpoint siteverify do Google retorna success: false. Mantenha a etapa de resolução o mais próxima possível do envio do formulário e evite armazenar tokens em cache entre requisições.
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. Veja como fazer 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 de callback para validar o token. Se o formulário não for enviado, encontre o nome da função no console (___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. Seu backend ainda pode rejeitar a requisição se a pontuação do token estiver abaixo do limiar configurado.
Outro problema comum é incompatibilidade de action. O token deve ser verificado com o mesmo valor action usado na criação da tarefa.
Para diagnosticar o problema:
Se success for true, o array error-codes geralmente está vazio — score e action são os principais campos a verificar.
Sim. Inclua isEnterprise: true na tarefa reCAPTCHA v3 (valores aceitos: true/false ou 1/0). Ela é processada como RecaptchaV3EnterpriseTask. Consulte a seção acima e a documentação da API.
Nenhuma ferramenta pode garantir uma taxa de sucesso de 100% diante de proteções em evolução, mas o CapMonster Cloud oferece uma alta taxa de sucesso na resolução de reCAPTCHA v3. Os dados se baseiam em testes comparativos internos mensais da equipe 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 pelo Google. O serviço se destina a dados disponíveis publicamente, testes de sites próprios ou autorizados, reconhecimento de imagens e acessibilidade. É proibida a coleta sem autorização de dados de terceiros protegidos por login ou acesso pago; suas próprias contas não são afetadas. Você determina a situação jurídica dos seus dados antes de começar.