Логотип «2Captcha»Перейти на главную страницу
API решения капчиПрокси APIFingerprint APIBrowser APIScraper API
Скачать Markdown

Yandex SmartCaptcha

Yandex SmartCaptcha

Мы предлагаем два метода решения Yandex SmartCaptcha в API v2: на основе токена и через координаты на изображении.

Для работы с этим методом используйте эндпоинт https://api.2captcha.com/createTask и получайте результат через https://api.2captcha.com/getTaskResult.

Спецификация методов

  • YandexSmartCaptchaTaskProxyless — решение с использованием наших прокси
  • YandexSmartCaptchaTask — решение с использованием ваших прокси
  • SmartCaptchaTask — решение Смарт Капчи по изображению с возвратом координат
  • PazlCaptchaTask — решение Калейдоскопа (капчи-пазла) по изображению

Решение с помощью токена

YandexSmartCaptchaTaskProxyless / YandexSmartCaptchaTask

Свойство Тип Обязателен Описание
type String Да Тип задачи: YandexSmartCaptchaTaskProxyless или YandexSmartCaptchaTask
websiteURL String Да Полный URL страницы, где загружена капча
websiteKey String Да Значение sitekey из кода страницы или iframe капчи
userAgent String Нет Ваш userAgent, который будет использован при решении
cookies String Нет Куки для передачи в запросе, формат: name1=value1;name2=value2

Прокси-параметры (только для YandexSmartCaptchaTask)

Свойство Тип Обязателен Описание
proxyType String Да Тип прокси: http, https, socks4, socks5
proxyAddress String Да IP-адрес или хост прокси-сервера
proxyPort Number Да Порт прокси-сервера
proxyLogin String Нет Логин для авторизации на прокси
proxyPassword String Нет Пароль для авторизации на прокси

Пример запроса

Метод: createTask
Эндпоинт: https://api.2captcha.com/createTask

json Copy 
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "YandexSmartCaptchaTaskProxyless",
    "websiteURL": "https://mysite.com/",
    "websiteKey": "Y5Lh0ti..."
  }
}

Пример ответа

Метод: getTaskResult
Эндпоинт: https://api.2captcha.com/getTaskResult

json Copy 
{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "token": "dV9xNjYyNTU3NjkxO4k9OTQuNVMuMjkuMjM9O9Q9MVEzQUEwMURERTY3RkUxQ9U3MTlEQzE3RjhYNTJCQUFFN9YyQTc3QUNFQjk9NzhVOTZGNjVCOEUyOVM4RTg9Q9VEQzY9NzY4O3U9MTY4MjU3NTY5MTQ4MTI3MVUyNVTo2ImVWMmQ4NWQzNjdlNzM9MVYhOGI5NWMxNWZlM4E4"
  }
}

Используйте полученный токен в поле smart-token или передайте его в бекенд сайта аналогично ручному решению капчи.

Решение с помощью изображения

Подходит для визуальных заданий Яндекс СмартКапчи. В зависимости от варианта капчи используйте SmartCaptchaTask (Смарт Капча) или PazlCaptchaTask (Калейдоскоп).

Спецификация задачи: SmartCaptchaTask (Смарт Капча)

Свойство Тип Обязателен Описание
type String Да Тип задачи: SmartCaptchaTask
image String Да Основное изображение капчи в формате Base64, 320×180
imgInstructions String Да Изображение инструкции в формате Base64, 480×180
comment String Нет* Текстовая подсказка для исполнителя.
* Рекомендуется, например: select objects in the order of the instruction

Пример запроса (SmartCaptchaTask)

Метод: createTask
Эндпоинт: https://api.2captcha.com/createTask

json Copy 
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "SmartCaptchaTask",
    "image": "BASE64_IMAGE",
    "imgInstructions": "BASE64_INSTRUCTION_IMAGE",
    "comment": "select objects in the order of the instruction"
  }
}

Пример ответа (SmartCaptchaTask)

Метод: getTaskResult
Эндпоинт: https://api.2captcha.com/getTaskResult

json Copy 
{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "coordinates": [
      {"x": 57, "y": 82},
      {"x": 239, "y": 75},
      {"x": 138, "y": 113},
      {"x": 154, "y": 42},
      {"x": 230, "y": 155}
    ]
  }
}

Обязательно передавайте imgInstructions — без него исполнитель может неверно понять задачу. Параметр comment помогает уточнить порядок действий, особенно если инструкция на изображении неочевидна.

Спецификация задачи: PazlCaptchaTask (Калейдоскоп)

Свойство Тип Обязателен Описание
type String Да Тип задачи: PazlCaptchaTask
image String Да Основное изображение капчи в формате Base64, 320×180
task String Да Шаги решения пазла в виде JSON-строки (например "[15,24,4,13,10,...]")

Пример запроса (PazlCaptchaTask)

Метод: createTask
Эндпоинт: https://api.2captcha.com/createTask

json Copy 
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "PazlCaptchaTask",
    "image": "BASE64_IMAGE",
    "task": "[15,24,4,13,10,...]"
  }
}

Пример ответа (PazlCaptchaTask)

json Copy 
{
  "errorId": 0,
  "status": "ready",
  "solution": "8",
  "cost": "0.0012",
  "ip": "1.2.3.4",
  "createTime": 1692863536,
  "endTime": 1692863556,
  "solveCount": 1
}

solution — строка с числом кликов по стрелочке слайдера, необходимых для решения капчи.