Содержание
API v1 in.php / res.php

QueryLabz API (v1)

API v1 использует классический поток in.php / res.php: сначала создайте задачу, затем опрашивайте результат.

Базовый URL
https://api.querylabz.com/
Эндпоинты: /in.php и /res.php.
Формат
По умолчанию plain text:
OK|<id>
JSON если json=1:
{ "status": 1, "request": "<id>" }

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

Используйте ваш API-ключ для аутентификации.

  • Передавайте параметр key в запросах к in.php и res.php.
Важно
API-ключ должен быть действительным, а на аккаунте должно быть достаточно средств. Иначе API вернет ошибку.

Тарифы

JavaScript CAPTCHA
reCAPTCHA / Turnstile / SmartCaptcha
$1.00 за 1000
($0.00100 за задачу)
Изображения CAPTCHA
base64-изображения / Pazl SmartCaptcha
$0.30 за 1000
($0.00030 за задачу)
Списание происходит, когда задача принимается в очередь.

Создание задачи - in.php

Отправьте задачу в API и получите идентификатор задачи.

Запрос
POST /in.php
Content-Type: application/x-www-form-urlencoded

key=<API_KEY>
method=<method>
...method-specific params...
json=0|1
Ответ
OK|123456789
Или JSON, если json=1.
Общие параметры
Параметр Обязателен Описание
key да Ваш API-ключ
method да Тип задачи (см. Методы).
json нет Установите 1, чтобы получать JSON-ответы.

Получение результата - res.php

Опрашивайте результат, пока он не будет готов.

Запрос
GET /res.php?action=get&key=<API_KEY>&id=<TASK_ID>&json=0|1
Ответы
CAPCHA_NOT_READY
OK|<answer>
ERROR_CAPTCHA_UNSOLVABLE
Совет: опрашивайте каждые 2-5 секунд, чтобы не упираться в rate limits.

Методы

Поддерживаемые значения method для in.php.

Изображение method=base64

Отправка image CAPTCHA в формате Base64.

Параметры
  • body - base64-изображение (Data URL допустим)
Пример
POST /in.php
key=API_KEY
method=base64
body=data:image/jpeg;base64,/9j/4AAQSk...
json=1

JS method=userrecaptcha (reCAPTCHA v2)

Решение reCAPTCHA v2 по sitekey и pageurl.

Параметры
  • googlekey - sitekey
  • pageurl - URL страницы
  • Опционально: proxy, proxytype, userAgent, cookies, invisible, enterprise
Пример
POST /in.php
key=API_KEY
method=userrecaptcha
googlekey=6Lc...
pageurl=https://site.com/
json=1

JS method=userrecaptcha (reCAPTCHA v3)

Решение reCAPTCHA v3 по sitekey, pageurl и необязательным action/min_score.

Параметры
  • googlekey - sitekey
  • pageurl - URL страницы
  • Опционально: action, min_score, proxy, proxytype, userAgent
  • version=v3
Пример
POST /in.php
key=API_KEY
method=userrecaptcha
googlekey=6Lc...
pageurl=https://site.com/
action=login
version=v3
min_score=0.3

JS method=turnstile (Cloudflare Turnstile)

Поддерживает стандартный Turnstile и режим Challenge с data.

Параметры
  • sitekey - Turnstile sitekey
  • pageurl - URL страницы
  • Опционально: data (режим Challenge), action, userAgent
Примеры
# Standard Turnstile
POST /in.php
key=API_KEY
method=turnstile
sitekey=0x4AAAA...
pageurl=https://site.com/
json=1
# Turnstile Challenge (with data)
POST /in.php
key=API_KEY
method=turnstile
sitekey=0x4AAAA...
pageurl=https://site.com/
data=cf_challenge_data_value
json=1

JS method=smartcaptcha

SmartCaptcha ожидает два изображения: body и task (Base64).

Параметры
  • body - base64-изображение
  • task - base64-изображение
Пример
POST /in.php
key=API_KEY
method=smartcaptcha
body=data:image/jpeg;base64,...
task=data:image/jpeg;base64,...

JS method=pazl_smartcaptcha (Pazl SmartCaptcha V2)

Передайте Base64-изображение и текст задания.

Параметры
  • body - base64-изображение
  • task - текст задания
Пример
POST /in.php
key=API_KEY
method=pazl_smartcaptcha
body=data:image/jpeg;base64,...
task=[...]
json=1

Форматы ответов

Текстовый ответ (по умолчанию)
OK|<id>
CAPCHA_NOT_READY
OK|<answer>
ERROR_*
JSON (json=1)
{
  "status": 1,
  "request": "123456789"
}
{
  "status": 0,
  "request": "CAPCHA_NOT_READY"
}

Ошибки

Ошибка Описание
ERROR_WRONG_USER_KEY API-ключ отсутствует или недействителен.
ERROR_NO_SLOT_AVAILABLE Очередь заполнена, попробуйте позже.
ERROR_ZERO_BALANCE Недостаточно средств.
ERROR_WRONG_METHOD Неподдерживаемый метод.
ERROR_BAD_FILE Неверные или отсутствующие данные изображения.
ERROR_WRONG_CAPTCHA_ID Идентификатор задачи не найден.
CAPCHA_NOT_READY Задача еще не решена.
ERROR_CAPTCHA_UNSOLVABLE Не удалось решить captcha.
Список ошибок может расширяться со временем. Всегда корректно обрабатывайте неизвестные ERROR_*.

Примеры

1) Создать задачу (base64)
curl -X POST "https://api.querylabz.com/in.php" \
  -d "key=API_KEY" \
  -d "method=base64" \
  -d "body=data:image/jpeg;base64,/9j/4AAQSk..." \
  -d "json=1"
2) Опрашивать результат
curl "https://api.querylabz.com/res.php?action=get&key=API_KEY&id=123456789&json=1"
3) Создать SmartCaptcha
curl -X POST "https://api.querylabz.com/in.php" \
  -d "key=API_KEY" \
  -d "method=smartcaptcha" \
  -d "body=data:image/jpeg;base64,..." \
  -d "task=data:image/jpeg;base64,..."
4) Создать Pazl SmartCaptcha
curl -X POST "https://api.querylabz.com/in.php" \
  -d "key=API_KEY" \
  -d "method=pazl_smartcaptcha" \
  -d "body=data:image/jpeg;base64,..." \
  -d "task=[...]" \
  -d "json=1"
Последнее обновление: v1 - QueryLabz