Documentación
Todo lo que necesitas para enviar tu primera resolución y conseguir que sea aceptada.
Tu primera resolución en cuatro pasos
- 01Crea una cuenta
Regístrate y verifica tu correo electrónico. Las cuentas nuevas reciben 0,10 US$ de crédito gratuito, sin necesidad de tarjeta.
- 02Crea una clave de API
En el panel, en Claves. Las claves empiezan por cn- y se muestran una sola vez, así que guarda la tuya en un lugar seguro.
- 03Envía una resolución
Haz un POST con el tipo, la sitekey y la URL de la página a /v1/solve?wait=60 con Authorization: Bearer cn-…
- 04Envía el token
Coloca el token donde la página lo espera y envíalo en unos dos minutos como máximo.
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 }Elige tu integración
Ejemplos funcionales contra la API real, con los problemas habituales propios de cada herramienta.
Consigue que tus tokens sean aceptados
La mayoría de los tokens válidos pero rechazados se deben a una de estas causas.
Un token generado en una IP o un navegador distintos de los que lo envían es la causa de rechazo más común.
Para reCAPTCHA v3, envía el mismo nombre de acción que usa la página. Si no coincide, la puntuación baja sin avisar.
Los tokens caducan en unos dos minutos y son de un solo uso. Resuelve justo antes de enviar, y de nuevo en cada reintento.
Bloqueo o sondeo
Con ?wait=N (hasta 120 segundos), la solicitud de resolución espera hasta que el resultado está listo. Sin él, recibes de inmediato un id de tarea y consultas GET /v1/task/{id} cada cinco segundos. Una solución pagada sigue disponible durante diez minutos, así que una conexión caída no te hace perder la resolución.
Facturación
Solo se te cobra cuando una resolución tiene éxito; las resoluciones fallidas son gratuitas. Cada respuesta incluye su cost, y GET /v1/balance devuelve tu crédito restante. Las tarifas por tipo están en la página de precios.
Claves y equipos
Una cuenta puede tener hasta diez claves activas. Ponles nombre por proyecto o por cliente y el panel mostrará el uso por clave; revocar una no afecta a las demás.
Preguntas frecuentes sobre la documentación
¿Hay un SDK oficial?
Sí. Hay SDK de código abierto para Python, Node.js y TypeScript, Go y PHP en GitHub. Aun así, no necesitas ninguno: CaptchaNo es una API REST simple con JSON de entrada y salida, así que sirve cualquier cliente HTTP, y las guías de integración muestran las pocas líneas necesarias en cada lenguaje y herramienta.
¿Qué tipos de desafío se admiten?
reCAPTCHA v2 (casilla e invisible), reCAPTCHA v3, widgets de tipo casilla de reCAPTCHA Enterprise, Cloudflare Turnstile, DataDome y captchas de imagen o texto, todos con la misma estructura de solicitud.
¿Necesito un proxy?
Para DataDome, sí, porque la cookie está vinculada a la IP que la obtuvo. Para los desafíos de token es opcional, pero mejora la aceptación, porque el sitio puede comparar dónde se produjo el token con dónde se envía.
¿Qué pasa cuando falla una resolución?
La tarea termina con el estado failed y un código de error, y no se te cobra. Vuelve a intentarlo con una solicitud nueva.
¿Dónde puedo ver mi uso?
El panel muestra cada resolución con su tipo, duración, costo y clave, además de tu saldo y el gasto por clave.
Guías útiles
¿Listo para construir?
Empieza con una prueba gratuita de 3 días y luego paga por cada resolución exitosa a medida que crece tu tráfico. No necesitas tarjeta para la prueba.