CaptchaNo
[ API ]

Una sola API para resolver captchas
para cada desafío

Cambia el campo type, no tu integración. Todos los desafíos que admitimos comparten la misma estructura de solicitud y de respuesta.

Solicitud
POST https://api.captchano.com/v1/solve?wait=60
Authorization: Bearer cn-YOUR_API_KEY
Content-Type: application/json

{
  "type":    "recaptcha_v2",
  "url":     "https://example.com/login",
  "sitekey": "6LcABC...",

  "proxy":     "http://user:pass@host:port",
  "userAgent": "Mozilla/5.0 ..."
}
Respuesta
200 OK

{
  "id":        "slv_3f9c0a7e1b2d4c6e8f0a1b2c",
  "status":    "ready",
  "type":      "recaptcha_v2",
  "solution":  {
    "token":     "03AGdBq25S...",
    "userAgent": "Mozilla/5.0 ..."
  },
  "cost":      "0.00598",
  "solveTime": 12.4,
  "createdAt": 1767225600000
}

Autenticación

Envía tu clave como Authorization: Bearer cn-… (o como encabezado X-API-Key). Crea y revoca claves en el panel. Las claves se muestran una sola vez y se guardan con hash, así que guarda una copia en un lugar seguro.

Endpoints

  • POST /v1/solve: envía un desafío. Sin wait, devuelve 202 con un id y status: "solving". Con ?wait=N (hasta 120 segundos), la solicitud espera hasta que la resolución está lista y devuelve 200, o devuelve 202 si todavía está en curso cuando termina la espera.
  • GET /v1/task/{id}: consulta una tarea. Consulta cada cinco segundos; el estado pasa de solving a ready o failed. Una solución pagada se puede recuperar durante diez minutos.
  • GET /v1/balance: tu crédito restante, en USD.

Tipos de desafío

  • recaptcha_v2 — url, sitekey; invisible opcional. $0.00598 por resolución exitosa.
  • recaptcha_v3 — url, sitekey; action y minScore opcionales. $0.00598 por resolución exitosa.
  • recaptcha_enterprise — url, sitekey; invisible opcional: widgets Enterprise de tipo casilla (no se admiten las claves Enterprise basadas en puntuación). $0.00598 por resolución exitosa.
  • turnstile — url, sitekey; action, cData y pageData opcionales. $0.00435 por resolución exitosa.
  • datadome — url, challengeUrl, proxy (obligatorio), userAgent. $0.00435 por resolución exitosa.
  • image — body (imagen en base64). $0.003 por resolución exitosa.

Campos que deciden la aceptación

proxy acepta una cadena como http://user:pass@host:port (se aceptan http, socks4 y socks5). Es opcional en los desafíos basados en token y obligatorio en DataDome. Pasar el proxy que enviará el token es el factor que más influye en la aceptación: un token generado desde una IP distinta es la causa más común de que se rechace un token que parece válido.

action y minScore se aplican al reCAPTCHA basado en puntuación. Envía la acción que indica la propia página; si no, la puntuación se penaliza en la verificación. Cuando la solución incluye un userAgent, reprodúcelo exactamente al enviarla.

Errores

Los errores incluyen un code estable y legible por máquina y un mensaje para personas, ya sea como { "error": { "code", "message" } } o en una tarea con status: "failed". Nada que no haya producido una solución utilizable se cobra.

  • invalid_api_key (401) — Clave ausente, revocada o incorrecta.
  • insufficient_balance (402) — El saldo no cubre una resolución. Recarga.
  • unsupported_type (400 / 422) — Tipo desconocido, falta url o falta un campo obligatorio.
  • invalid_sitekey (422) — La sitekey fue rechazada para esa página.
  • proxy_required (422) — Se solicitó DataDome sin proxy.
  • proxy_unreachable (400 / 422) — Cadena de proxy mal formada o el proxy rechazó la conexión.
  • unsolvable (422) — No se pudo resolver el desafío. No se cobra.
  • capacity_unavailable (503 / 422) — Temporalmente no se pueden aceptar resoluciones. Reintenta con backoff.
  • task_not_found (404) — No hay ninguna tarea con ese id en tu cuenta.
  • upstream_error (422) — No se pudo completar la resolución. No se cobra.

Facturación

Cada respuesta ready indica su cost en USD, que se descuenta de tu saldo prepago. Las resoluciones fallidas no cuestan nada. Los precios de cada tipo están en la página de precios.

SDK

La API es HTTPS y JSON sin más, así que no necesitas ningún paquete. Si prefieres usar uno, los SDK oficiales de código abierto cubren todos los tipos, los errores tipados y la espera bloqueante: Python, Node.js y TypeScript, Go y PHP.

Ejemplos

En la documentación encontrarás ejemplos funcionales para Selenium, Puppeteer, Playwright y Scrapy, además de wrappers de herramientas para frameworks de agentes de IA.

¿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.

Ver nuestros planes
¿Eres un agente de IA? Consulta las opciones de configuración →