CaptchaNo
[ API ]

Один API для решения капчи
для любых проверок

Меняйте поле type, а не интеграцию. Все поддерживаемые проверки используют один формат запроса и один формат ответа.

Запрос
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 ..."
}
Ответ
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
}

Аутентификация

Передавайте ключ как Authorization: Bearer cn-… (или в заголовке X-API-Key). Создавайте и отзывайте ключи в личном кабинете. Ключи показываются один раз и хранятся в хешированном виде, поэтому сохраните копию в надёжном месте.

Эндпоинты

  • POST /v1/solve — отправить проверку на решение. Без wait возвращает 202 с id и status: "solving". С ?wait=N (до 120 секунд) запрос ожидает готовности решения и возвращает 200 либо 202, если по истечении ожидания решение ещё выполняется.
  • GET /v1/task/{id} — опросить задачу. Опрашивайте каждые пять секунд; статус меняется с solving на ready или failed. Оплаченное решение можно получить в течение десяти минут.
  • GET /v1/balance — остаток баланса в USD.

Типы проверок

  • recaptcha_v2 — url, sitekey; необязательно invisible. $0.00598 за успешное решение.
  • recaptcha_v3 — url, sitekey; необязательно action, minScore. $0.00598 за успешное решение.
  • recaptcha_enterprise — url, sitekey; необязательно invisible — виджеты Enterprise в стиле чекбокса (Enterprise-ключи с оценкой не поддерживаются). $0.00598 за успешное решение.
  • turnstile — url, sitekey; необязательно action, cData, pageData. $0.00435 за успешное решение.
  • datadome — url, challengeUrl, proxy (обязательно), userAgent. $0.00435 за успешное решение.
  • image — body (изображение в base64). $0.003 за успешное решение.

Поля, от которых зависит принятие

proxy принимает строку вида http://user:pass@host:port (поддерживаются http, socks4 и socks5). Для проверок с токенами он необязателен, для DataDome — обязателен. Передача прокси, с которого будет отправлен токен, сильнее всего влияет на принятие: токен, полученный с другого IP, — самая частая причина, по которой внешне валидный токен отклоняется.

action и minScore применяются к reCAPTCHA с оценкой. Передавайте action, который сообщает сама страница, иначе при проверке оценка будет занижена. Если решение содержит userAgent, в точности воспроизведите его при отправке.

Ошибки

Ошибки содержат стабильный машиночитаемый code и сообщение для человека — либо в виде { "error": { "code", "message" } }, либо в задаче со status: "failed". Всё, что не дало пригодного решения, не оплачивается.

  • invalid_api_key (401) — Ключ отсутствует, отозван или неверен.
  • insufficient_balance (402) — Баланса не хватает на одно решение. Пополните его.
  • unsupported_type (400 / 422) — Неизвестный type, отсутствует url или обязательное поле.
  • invalid_sitekey (422) — sitekey отклонён для этой страницы.
  • proxy_required (422) — DataDome запрошен без прокси.
  • proxy_unreachable (400 / 422) — Строка прокси имеет неверный формат или прокси отклонил соединение.
  • unsolvable (422) — Проверку не удалось решить. Не оплачивается.
  • capacity_unavailable (503 / 422) — Временно не можем принимать задачи. Повторите попытку с увеличивающейся задержкой.
  • task_not_found (404) — В вашем аккаунте нет задачи с таким id.
  • upstream_error (422) — Решение не удалось завершить. Не оплачивается.

Оплата

Каждый ответ ready сообщает свою стоимость cost в USD, которая списывается с вашего предоплаченного баланса. Неудачные решения ничего не стоят. Цены на все типы — на странице цен.

SDK

API работает на обычных HTTPS и JSON, поэтому никакой пакет не требуется. Если вам удобнее SDK, официальные SDK с открытым исходным кодом поддерживают все типы, типизированные ошибки и блокирующее ожидание: Python, Node.js и TypeScript, Go и PHP.

Примеры

Рабочие примеры для Selenium, Puppeteer, Playwright и Scrapy, а также обёртки-инструменты для фреймворков ИИ-агентов есть в документации.

Готовы начать?

Начните с бесплатного 3-дневного пробного периода, а по мере роста трафика платите за каждое успешное решение. Для пробного периода карта не нужна.

Посмотреть тарифы
Вы ИИ-агент? Посмотрите варианты подключения →