API для решения капчи
EverySolve — API для решения капчи с каталогом из 52 типов проверок. Отправьте запрос на POST /api/v1/captcha с типом проверки и обязательными для него входными данными. Формат результата зависит от типа, а платите вы только при успешном предоставлении решения.
52 types$0.14–$4.58 за 1 000 успешных решений9 форматы решений
Как определить тип проверки
Начните с самого надёжного признака на странице. Большинство интеграций можно определить по загруженному скрипту и атрибутам контейнера ещё до отправки запроса.
- 01Изучите скрипты, которые загружает страница. URL скрипта конкретной проверки обычно самый надёжный признак.
- 02Изучите data-атрибуты контейнера проверки. Используйте их вместе с признаком по скрипту, потому что такие имена, как
data-sitekey, встречаются у нескольких виджетов. - 03Если скрипты собраны в бандл или обфусцированы, изучите глобальные объекты конкретной проверки в среде выполнения браузера.
- 04Если страница целиком блокирует доступ до загрузки нужного содержимого, используйте тип для страницы-проверки. Такие типы обычно возвращают значения cookie, а не токен формы.
- 05Если у вас есть только изображение или вопрос без целевой страницы, выберите задачу для изображения, текста, точек, рамок или чисел в зависимости от нужного формата ответа.
curl -X POST https://api.everyinfra.com/api/v1/captcha \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"type":"turnstile","website_url":"https://example.com","website_key":"SITE_KEY"}'
Брендовые виджеты проверки
Виджет, встроенный в страницу или форму; обычно возвращает токен или именованные поля.
Капча Alibaba
Капча Alibaba Cloud может выглядеть как проверка кликом, слайдер, пазл или другой виджет, адаптирующийся к уровню риска; это не отдельная защита Alibaba на уровне страницы. Возвращённый токен относится к процессу проверки виджета; не используйте его как cookie для доступа к странице.
CaptchaFox
CaptchaFox — виджет с ключом сайта; прежде чем копировать ключ, определите его скрипт или конфигурацию виджета. Возвращает токен виджета, а не cookie для доступа к странице. Не используйте ключ reCAPTCHA или Turnstile только потому, что в DOM тоже есть sitekey.
Capy Puzzle CAPTCHA
Capy Puzzle CAPTCHA использует ключ сайта и может обращаться к API-серверу конкретного развёртывания. Ответ содержит поля captchakey, challengekey и answer, которые нужно считывать вместе; это не единый токен.
Friendly Captcha
Friendly Captcha — виджет на основе proof-of-work со своим ключом сайта и необязательным эндпоинтом клиентской библиотеки. Возвращает токен виджета. Это не ALTCHA, не MTCaptcha и не невидимая reCAPTCHA, даже если взаимодействие почти не требует действий от пользователя.
Arkose Labs FunCaptcha
Arkose Labs FunCaptcha обычно можно распознать по скрипту Arkose или значению data-pkey/public-key; она может показывать интерактивные 3D- или визуальные задания. Возвращает токен сессии Arkose, который обычно передаётся через поле fc-token. Это не данные reCAPTCHA Enterprise.
Капча GeeTest
GeeTest использует CAPTCHA ID/ключ сайта и может показывать адаптивную проверку, слайдер, проверку кликом или другие формы. Результат — набор проверочных данных из пяти полей: captcha_id, lot_number, pass_token, gen_time и captcha_output, а не один универсальный токен.
hCaptcha
hCaptcha — виджет h-captcha или явный вызов hcaptcha.render с собственным data-sitekey. API возвращает ответ hCaptcha в gRecaptchaResponse. Название поля не означает, что виджет — Google reCAPTCHA.
Lemin CAPTCHA
Lemin CAPTCHA может работать в блочном или невидимом режиме и использует ключ сайта, а также необязательные контейнер и API-сервер. Возвращает answer и challenge_id вместе. Не путайте это с единым токеном, который возвращают MTCaptcha или Turnstile.
MTCaptcha
MTCaptcha — отдельный виджет, который обычно настраивается ключом сайта MTCaptcha; несмотря на похожее название, это не Yandex SmartCaptcha. Возвращает токен MTCaptcha. Yandex SmartCaptcha загружает скрипты Yandex Cloud и использует smart-token; ключи сайтов не взаимозаменяемы.
Prosopo Procaptcha
Prosopo Procaptcha — виджет с ключом сайта, который в зависимости от конфигурации может предлагать вычислительные задания proof-of-work или визуальные задания. Возвращает токен Procaptcha. Один лишь атрибут data-sitekey не делает виджет reCAPTCHA, hCaptcha или Turnstile.
Сетка изображений reCAPTCHA
Задача reCAPTCHA grid решает уже извлечённое графическое задание; она не открывает страницу и не генерирует токен reCAPTCHA для сайта. Возвращает индексы подходящих ячеек в objects: отсчёт начинается с 0 с левой верхней ячейки и идёт слева направо, ряд за рядом. Для полного сценария с токеном виджета используйте recaptcha_v2.
reCAPTCHA v2
reCAPTCHA v2 — классический виджет с чекбоксом или невидимый виджет v2, загружаемый через api.js и настраиваемый с помощью ключа сайта. Возвращает gRecaptchaResponse для целевой формы. reCAPTCHA v3 работает на основе оценки (score), а версия Enterprise загружается через enterprise.js и использует контекст, предназначенный для Enterprise.
reCAPTCHA v2 Enterprise
reCAPTCHA v2 Enterprise использует ключ Enterprise для виджета с чекбоксом или для проверки с поведением, задаваемым политикой, и работает через enterprise.js и grecaptcha.enterprise. Задача тоже возвращает gRecaptchaResponse, но идентификаторы и данные Enterprise нельзя смешивать со значениями классической reCAPTCHA v2 из api.js или с ключами reCAPTCHA v3 на основе оценки.
reCAPTCHA v3
reCAPTCHA v3 основана на оценке и обычно работает через grecaptcha.execute без показа чекбокса v2. EverySolve возвращает gRecaptchaResponse, а не оценку Google. Токен и действие проверяет бэкенд защищённого сайта.
reCAPTCHA v3 Enterprise
reCAPTCHA v3 Enterprise использует ключ Enterprise на основе оценки и работает через enterprise.js и grecaptcha.enterprise.execute. Возвращает gRecaptchaResponse для оценки в Enterprise. В reCAPTCHA v3 Enterprise нет чекбокса v2, и её нельзя считать классической reCAPTCHA v3 через api.js только потому, что обе версии невидимы.
Tencent Tendi CAPTCHA
Tencent Tendi CAPTCHA использует captchaAppId/ключ сайта и после интерактивной проверки может возвращать ticket и randstr. Параметры ticket и randstr нужно использовать вместе. Они не являются ни токеном ответа reCAPTCHA, ни cookie для доступа к странице.
Cloudflare Turnstile
Cloudflare Turnstile — встроенный виджет, настроенный ключом сайта Turnstile. Он может работать в управляемом, неинтерактивном или невидимом режиме. Возвращает токен для cf-turnstile-response. Страница проверки Cloudflare, напротив, блокирует переход и возвращает данные cookie для доступа к странице.
NetEase Yidun CAPTCHA
Капча NetEase Yidun, также известная как NECaptcha, инициализируется с собственным captchaId и может показывать проверку со слайдером, задание с кликами или адаптивную проверку с учётом риска. Возвращает токен Yidun. Идентификатор captchaId и значения обратного вызова Yidun — это не ticket/randstr Tencent и не результат GeeTest из пяти полей.
Полностраничные проверки доступа
Блокировка на уровне страницы, для снятия которой используются значения cookie или данные заголовков запроса.
Akamai Bot Manager для мобильных SDK
Это сценарий для мобильного SDK: целью является пакет приложения iOS или Android, а не виджет на веб-странице. Возвращается согласованный набор из сенсорных данных, user agent и ID устройства. Эти три значения используются вместе; это не тот cookie, который возвращает веб-сценарий Akamai.
Akamai sec-cpt
Ответ sec-cpt — промежуточная проверка Akamai с cookie проверки и JSON-данными из заблокированного ответа. Эта задача возвращает токен проверки после ожидания, заданного самой проверкой. Она отличается от задачи получения веб-cookie Akamai, для которой нужен только URL.
Akamai Bot Manager для веба
Это браузерный сценарий Akamai Bot Manager; на него обычно указывают cookie вроде _abck или bm_sz, а не встроенный чекбокс. Результат — строка cookie для того же браузерного сценария, а не мобильные сенсорные данные и не токен sec-cpt.
Anubis
Anubis — полностраничный шлюз на основе proof-of-work; его можно узнать по данным anubis_challenge и странице прогресса, а не по виджету в форме. Возвращается cookie шлюза, а не токен встроенного виджета. Срок действия cookie и возможность его использования по-прежнему определяются защищённым сайтом.
AWS WAF CAPTCHA
AWS WAF CAPTCHA — проверка на уровне страницы или приложения, после прохождения которой браузер получает токен. Эта задача возвращает данные cookie для последующих запросов. aws_waf_classify только определяет положения объектов на изображениях проверки и не обеспечивает её прохождение.
Basilisk
Basilisk, также встречающийся под названием FaucetPay CAPTCHA, — виджет с ключом сайта, ответ которого передаётся вместе со значением User-Agent. Считывайте captcha_response вместе с user_agent; это не единый токен, как у reCAPTCHA или Turnstile.
Castle
Castle — сценарий оценки рисков и анализа устройств, в котором целевой сайт передаёт структурированные метаданные, а не видимую графическую головоломку. Возвращает набор токенов. Не сводите его к одному токену и не делайте вывод о визуальной капче по названию продукта.
Страница проверки Cloudflare
Страница проверки Cloudflare блокирует целевую страницу до её загрузки и отличается от встроенного виджета Turnstile. Результат — данные cookie, например маркер прохождения проверки. Turnstile же возвращает токен формы и использует ключ сайта.
CyberSiARA
CyberSiARA определяет встроенную проверку SiARA по целевой странице и идентификатору master URL. Возвращает токен для этой сессии SiARA, а не cookie для прохождения общей защиты от ботов на уровне страницы.
Капча DataDome
Задача DataDome CAPTCHA начинается с captcha_url, уже выданного для заблокированной сессии. Возвращает данные cookie, привязанные к этому сценарию. datadome_interstitial начинается не с URL капчи, а с URL защищённого сайта.
Промежуточная страница DataDome
Промежуточная страница DataDome — блокировка на уровне страницы при переходе по защищённому URL, а не отдельная задача с captcha_url. Возвращает данные cookie. Если активный captcha_url DataDome уже есть, используйте datadome.
F5 Shape
F5 Shape — сценарий с браузерными проверками для защищённой страницы, а не видимая задача на распознавание изображений. Возвращает данные cookie для работы с защищённой страницей. f5_tspd относится к отдельному семейству cookie с префиксом TS, поэтому выбирать этот тип только по названию не следует.
Защита F5 TS
На защиту F5 TS указывают cookie с префиксом TS и поведение страницы, характерное для модуля защиты BIG-IP. Результат — данные cookie семейства TS, а не заголовки F5 Shape и не токен встроенного виджета.
Проверка Imperva
Imperva, ранее известная как Incapsula, защищает страницу с помощью проверок в браузере и на периферии сети, а не отдельного графического виджета. Возвращает данные cookie для защищённого сценария, а не токен виджета и не список ресурсов страницы.
Kasada
На браузерный сценарий Kasada указывают запросы x-kpsdk и связанные с защищённой страницей заголовки ответов. Возвращает поля x-kpsdk-ct, x-kpsdk-cd, x-kpsdk-v, x-kpsdk-r и x-kpsdk-st, а не строку cookie браузера.
Данные проверки Kasada
Генерация данных проверки Kasada начинается со структурированных platform_inputs, а не с перехода по защищённому URL. Возвращает x-kpsdk-cd вместе со связанными значениями ct и st. Для браузерного сценария с URL и прокси используйте kasada.
Проверка PerimeterX
PerimeterX, теперь часть HUMAN Security, — сценарий защиты приложения на уровне страницы, а не встроенный чекбокс. Возвращает cookie для прохождения защиты в рамках сессии, а не токен формы и не объявление о недвижимости с защищённого сайта.
Задачи с изображениями и вопросами
Подходят, когда на входе уже есть изображение или задание, а на выходе нужен текст, координаты, рамки или число.
Аудиокапча
Эта задача расшифровывает переданную аудиокапчу; она не загружает аудио со страницы и не решает графические проверки. Возвращает текст. Для символов на статичном изображении используйте image, для письменного вопроса — text_captcha.
Классификация проверок AWS WAF
Это часть AWS WAF CAPTCHA, отвечающая за классификацию изображений: используются изображения проверки и показанная инструкция. В поле box возвращаются позиции для кликов, а не cookie для прохождения AWS WAF. Вызывающая сторона по-прежнему сама управляет взаимодействием с браузером.
BotDeflector
BotDeflector здесь — задача на выбор изображений: иконки из icons нужно по порядку найти на изображении из body. Возвращает точки, а не токен формы или cookie браузера, поэтому применять эти позиции должна вызывающая сторона.
Капча с выделением объектов рамкой
В задаче с ограничивающими рамками нужно обвести прямоугольниками подходящие объекты на одном исходном изображении. Возвращает bounding_boxes с геометрией прямоугольников. Для точек клика используйте coordinates, для выбора плиток или объектов — recaptcha_grid.
Капча с кликом по координатам
Задача с координатами описывает одну или несколько точек клика на изображении и не привязана к конкретному поставщику капчи. Возвращает точки координат, а не прямоугольники, текст или расстояние перетаскивания. Вызывающая сторона должна применять эти точки с учётом исходных размеров изображения.
Капча-изображение
Задача image распознаёт символы на переданном изображении; это не интеграция с виджетом конкретного бренда. Возвращает распознанный текст. Для звука используйте audio, для письменного вопроса — text_captcha, для пространственных ответов — задачи с координатами или рамками.
Капча с поворотом
Задача на поворот получает одно изображение, которое нужно повернуть в правильное положение; это универсальная визуальная задача. Возвращает angle в виде числа. Для расстояния перетаскивания используйте slider, для кликов — coordinates, для прямоугольников — bounding_box.
Капча SHEIN
Задача SHEIN — модель поиска иконок, созданная для конкретного сайта, а не универсальная задача с ограничивающими рамками. Возвращает rects для подходящих областей. Для изображений с других сайтов используйте подходящую универсальную задачу с точками или рамками.
Капча-слайдер
Задача со слайдером использует фоновое изображение и отдельный фрагмент пазла, чтобы вычислить, на какое расстояние нужно сдвинуть фрагмент. Возвращает расстояние в пикселях, а не координату, процент, токен или траекторию перетаскивания. Клиент самостоятельно формирует траекторию взаимодействия.
Капча Temu
Задача Temu сопоставляет упорядоченный массив parts с основным изображением проверки. Возвращает координаты в том же порядке, что и изображения-кандидаты в parts. Это не задача с координатами для одного изображения, и токен сайта она не возвращает.
Текстовая капча
Текстовая капча — это вопрос, на который нужно дать текстовый ответ; часто такую капчу предоставляет форум или CMS, а не поставщик стороннего виджета. Возвращает текст ответа. Для символов на изображении используйте image, для голосовой проверки — audio.
Другие типы проверок
Прочие проверки со своими параметрами запроса и полями решения.
ALTCHA
ALTCHA — виджет на основе proof-of-work, обычно представленный элементом altcha-widget, а не сеткой изображений. Возвращается токен формы, полученный в результате выполнения proof-of-work, а не визуальный ответ и не cookie для доступа к странице.
ATB CAPTCHA
atbCAPTCHA инициализируется с appId и apiServer и может показывать проверку кликом, слайдер или адаптивную проверку по уровню риска. Результат — токен atbCAPTCHA. Сходство с виджетом другого бренда не означает, что идентификаторы этих виджетов взаимозаменяемы.
Капча Binance
Для задачи Binance требуется validate_id активной проверки, а не произвольное изображение или ключ сайта reCAPTCHA. Возвращает токен проверки для этой сессии валидации. Устаревший идентификатор или идентификатор из другого сценария использовать вместо него нельзя.
Cutcaptcha
Cutcaptcha использует ключ Misery и отдельный API-ключ капчи для проверки, которая выдаёт токен. Возвращает токен; ни один из ключей не является обычным ключом сайта, и смешивать их роли нельзя.
Hunt CAPTCHA
Hunt зарегистрирован как задача с токеном по URL, но устойчивая публичная сигнатура поставщика пока не описана. Возвращает токен. Поскольку проверенной публичной сигнатуры нет, ориентируйтесь на запись в каталоге; на этой странице не приводятся DOM-селекторы конкретного поставщика.
Yandex SmartCaptcha
Yandex SmartCaptcha — виджет Yandex Cloud, который загружается скриптами SmartCaptcha; проверка выполняется через собственный API виджета. Возвращает токен для поля smart-token. MTCaptcha — другой продукт с другими скриптами и серверной проверкой.
Форматы решений: как их использовать
Объект solution использует один из 9 поддерживаемых форматов ответа. Для типов с одинаковым форматом можно использовать общий код разбора ответа, хотя параметры запроса у них могут различаться.
| Формат решения | Что возвращает | Как использовать | Типы |
|---|---|---|---|
boxes | Ограничивающие рамки | Используйте координаты каждой рамки, чтобы определить или выделить область на исходном изображении. | 2 |
cookie | Значения cookie | Добавляйте полученные поля cookie к последующим запросам в рамках того же сценария. | 10 |
fields | Именованные поля | Считывайте объявленные поля вместе: целевому сценарию может понадобиться весь набор. | 8 |
indices | Индексы ячеек сетки | Кликните по указанным ячейкам: нумерация начинается с 0 в левой верхней ячейке и идёт слева направо, ряд за рядом. Пустой список означает, что подходящих ячеек нет. | 1 |
number | Число | Используйте полученное числовое значение как ответ на проверку. | 2 |
points | Координаты точек | Соотнесите полученные координаты в пикселях с исходным изображением или используйте их для кликов в указанном порядке. | 4 |
text | Текст | Используйте полученный текст как ответ на проверку. | 3 |
token | Токен | Передайте токен в поле либо в запросе проверки, как предусмотрено целевым сценарием. | 21 |
tokens | Набор токенов | Передайте полученные токены вместе, в том виде, в каком их ожидает запрос целевого сайта. | 1 |
Вопросы об API для решения капчи
Как определить, какая капча используется на странице?
Сначала изучите загруженные скрипты, затем data-атрибуты контейнера проверки и, наконец, глобальные объекты браузера, специфичные для проверки. Если вся страница блокируется до загрузки, используйте тип для страницы-проверки, а не тип встроенного виджета.
Списываются ли средства за неудачное решение?
Нет. EverySolve списывает средства только при успешном предоставлении решения. За неудачный или пустой результат итоговое списание не производится, а зарезервированная сумма автоматически возвращается на тот же баланс аккаунта.
Сколько кода нужно менять при смене типа капчи?
Эндпоинт остаётся прежним: POST /api/v1/captcha. Измените значение type и передайте параметры, объявленные для этого типа. Можно использовать общий код разбора ответа, если два типа используют один и тот же формат из 9 доступных форматов ответа.
Что означает поле available?
GET /api/v1/captcha/types возвращает список из 52 типов и сообщает, доступен ли каждый из них в данный момент. Проверяйте текущую доступность перед отправкой запроса: кешированное значение не даёт гарантий.