Documentação
Tudo o que você precisa para enviar sua primeira resolução e garantir que ela seja aceita.
Sua primeira resolução em quatro passos
- 01Crie uma conta
Cadastre-se e verifique seu e-mail. Novas contas recebem US$ 0,10 de crédito grátis, sem precisar de cartão.
- 02Crie uma chave de API
No painel, em Chaves de API. As chaves começam com cn- e são exibidas uma única vez, então guarde a sua em um lugar seguro.
- 03Envie uma resolução
Faça um POST com type, sitekey e a URL da página para /v1/solve?wait=60 com Authorization: Bearer cn-…
- 04Envie o token
Coloque o token onde a página espera e envie em até cerca de dois minutos.
curl -X POST "https://api.captchano.com/v1/solve?wait=60" \
-H "Authorization: Bearer cn-YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "recaptcha_v2",
"sitekey": "6LcABC...",
"url": "https://example.com/login",
"proxy": "http://user:pass@host:port"
}'
# 200 OK
# { "id": "slv_…", "status": "ready",
# "solution": { "token": "03AGdBq25S…" },
# "cost": "0.00598", "solveTime": 18.4 }Escolha sua integração
Exemplos funcionais contra a API real, com as armadilhas específicas de cada ferramenta.
Faça seus tokens serem aceitos
A maioria dos tokens válidos que acabam rejeitados se deve a um destes motivos.
Um token gerado em um IP ou navegador diferente daquele que o envia é a causa mais comum de rejeição.
No reCAPTCHA v3, envie o mesmo nome de action que a página usa. Uma divergência reduz a pontuação silenciosamente.
Os tokens expiram em cerca de dois minutos e são de uso único. Resolva logo antes de enviar, e de novo a cada nova tentativa.
Bloqueante ou polling
Com ?wait=N (até 120 segundos), a requisição de resolução fica aguardando até o resultado ficar pronto. Sem isso, você recebe imediatamente um id de tarefa e faz polling em GET /v1/task/{id} a cada cinco segundos. Uma solução paga continua disponível para consulta por dez minutos, então uma conexão perdida não faz você perder a resolução.
Cobrança
Você só é cobrado quando uma resolução tem sucesso; resoluções que falham são grátis. Cada resposta inclui seu cost, e GET /v1/balance retorna seu crédito restante. Os valores por tipo estão na página de preços.
Chaves e equipes
Uma conta pode ter até dez chaves ativas. Dê nomes a elas por projeto ou por cliente e o painel mostra o uso por chave; revogar uma não afeta as outras.
Perguntas frequentes sobre a documentação
Existe um SDK oficial?
Sim. Há SDKs de código aberto para Python, Node.js e TypeScript, Go e PHP no GitHub. Mas você não precisa de nenhum: a CaptchaNo é uma API REST simples, com JSON na entrada e na saída, então qualquer cliente HTTP funciona, e os guias de integração mostram as poucas linhas necessárias em cada linguagem e ferramenta.
Quais tipos de desafio são suportados?
reCAPTCHA v2 (caixa de seleção e invisível), reCAPTCHA v3, widgets reCAPTCHA Enterprise no estilo caixa de seleção, Cloudflare Turnstile, DataDome e captchas de imagem ou texto, todos pelo mesmo formato de requisição.
Preciso de um proxy?
Para o DataDome, sim, porque o cookie fica vinculado ao IP que o obteve. Para desafios de token, é opcional, mas melhora a aceitação, porque o site pode comparar onde o token foi gerado com onde ele é enviado.
O que acontece quando uma resolução falha?
A tarefa termina com status failed e um código de erro, e você não é cobrado. Tente novamente com uma nova requisição.
Onde vejo meu uso?
O painel lista cada resolução com tipo, duração, custo e chave, e mostra seu saldo e o gasto por chave.
Guias que ajudam
Pronto para começar?
Comece com um teste grátis de 3 dias e depois pague por resolução bem-sucedida conforme seu tráfego cresce. Não é preciso cartão para o teste.