API v1 in.php / res.php

QueryLabz API (v1)

A API v1 segue o fluxo classico in.php / res.php: primeiro crie a tarefa, depois consulte o resultado.

URL base

https://api.querylabz.com/

Endpoints: /in.php e /res.php.

Formato

Texto simples por padrao:

OK|<id>

JSON quando json=1:

{ "status": 1, "request": "<id>" }

Autenticacao

Autentique-se com sua chave de API.

Envie o parametro key nas requisicoes para in.php e res.php.

Importante

A chave de API deve ser valida e a conta precisa ter saldo suficiente. Caso contrario, a API retornara um erro.

Precos

CAPTCHAs JavaScript

reCAPTCHA / Turnstile / SmartCaptcha

$1.00 por 1000

($0.00100 por tarefa)

CAPTCHAs de imagem

imagens base64 / Pazl SmartCaptcha

$0.30 por 1000

($0.00030 por tarefa)

A cobranca acontece quando a tarefa e aceita na fila.

Criar tarefa - in.php

Envie uma tarefa para a API e receba um id de tarefa.

Requisicao

POST /in.php
Content-Type: application/x-www-form-urlencoded

key=<API_KEY>
method=<method>
...method-specific params...
json=0|1

Resposta

OK|123456789

Ou JSON quando json=1.

Parametros comuns

Parametro	Obrigatorio	Descricao
key	sim	Sua chave de API
method	sim	Tipo de tarefa (veja Metodos).
json	nao	Defina 1 para receber respostas JSON.

Obter resultado - res.php

Consulte o resultado ate que ele esteja pronto.

Requisicao

GET /res.php?action=get&key=<API_KEY>&id=<TASK_ID>&json=0|1

Respostas

CAPCHA_NOT_READY
OK|<answer>
ERROR_CAPTCHA_UNSOLVABLE

Dica: consulte a cada 2-5 segundos para evitar limites de taxa.

Metodos

Valores suportados de method para in.php.

Imagem method=base64

Envie um CAPTCHA de imagem em Base64.

Parametros

body - imagem em base64 (Data URL permitido)

Exemplo

POST /in.php
key=API_KEY
method=base64
body=data:image/jpeg;base64,/9j/4AAQSk...
json=1

JS method=userrecaptcha (reCAPTCHA v2)

Resolva reCAPTCHA v2 usando sitekey e pageurl.

Parametros

googlekey - sitekey
pageurl - URL da pagina
Opcional: proxy, proxytype, userAgent, cookies, invisible, enterprise

Exemplo

POST /in.php
key=API_KEY
method=userrecaptcha
googlekey=6Lc...
pageurl=https://site.com/
json=1

JS method=userrecaptcha (reCAPTCHA v3)

Resolva reCAPTCHA v3 usando sitekey, pageurl e action/min_score opcionais.

Parametros

googlekey - sitekey
pageurl - URL da pagina
Opcional: action, min_score, proxy, proxytype, userAgent
version=v3

Exemplo

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)

Suporta tanto o Turnstile padrao quanto o modo Challenge com data.

Parametros

sitekey - Turnstile sitekey
pageurl - URL da pagina
Opcional: data (modo Challenge), action, userAgent

Exemplos

# 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

O SmartCaptcha espera duas imagens: body e task (Base64).

Parametros

body - imagem em base64
task - imagem em base64

Exemplo

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)

Envie uma imagem Base64 e o texto da tarefa.

Parametros

body - imagem em base64
task - texto da tarefa

Exemplo

POST /in.php
key=API_KEY
method=pazl_smartcaptcha
body=data:image/jpeg;base64,...
task=[...]
json=1

Formatos de resposta

Texto simples (padrao)

OK|<id>
CAPCHA_NOT_READY
OK|<answer>
ERROR_*

JSON (json=1)

{
  "status": 1,
  "request": "123456789"
}

{
  "status": 0,
  "request": "CAPCHA_NOT_READY"
}

Erros

Erro	Descricao
ERROR_WRONG_USER_KEY	A chave de API esta ausente ou e invalida.
ERROR_NO_SLOT_AVAILABLE	A fila esta cheia, tente novamente mais tarde.
ERROR_ZERO_BALANCE	Saldo insuficiente.
ERROR_WRONG_METHOD	Metodo nao suportado.
ERROR_BAD_FILE	Dados de imagem invalidos ou ausentes.
ERROR_WRONG_CAPTCHA_ID	O id da tarefa nao foi encontrado.
CAPCHA_NOT_READY	A tarefa ainda nao foi resolvida.
ERROR_CAPTCHA_UNSOLVABLE	Nao foi possivel resolver a captcha.

Os codigos de erro podem crescer com o tempo. Sempre trate corretamente erros desconhecidos ERROR_*.

Exemplos

1) Criar tarefa (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) Consultar resultado

curl "https://api.querylabz.com/res.php?action=get&key=API_KEY&id=123456789&json=1"

3) Criar 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) Criar 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"