সংক্ষিপ্ত বিবরণ
JSON মেথড
টোকেন টাস্ক
- reCAPTCHA v2
- reCAPTCHA v2 Enterprise
- reCAPTCHA v3
- Cloudflare Turnstile
- GeeTest v3 / v4
- FunCaptcha (Arkose Labs)
- Amazon AWS WAF
- MTCaptcha
- Friendly Captcha
- Lemin Cropped Captcha
- DataDome
- KeyCaptcha
- Capy Puzzle
- Cloudflare Challenge পেজ
- Cutcaptcha
- CyberSiARA
- atbCAPTCHA
- Tencent Captcha
- Prosopo Procaptcha
- CaptchaFox
- Altcha
- NetEase Yidun
- Yandex SmartCaptcha
- VK Captcha
- Binance Captcha
- কাস্টম টাস্ক (Imperva, Temu ও অন্যান্য)
UNLOCK API ডকুমেন্টেশন
CAPTCHA টাস্ক হিসেবে পাঠান, তারপর উত্তর নিন। API অন্যান্য সলভার API-এর মতোই একই মেথড নাম, টাস্ক নাম ও এরর কোড ব্যবহার করে, তাই হোস্ট ও key বদলালেই বেশিরভাগ পুরোনো কোড চলে।
রিকোয়েস্ট কীভাবে কাজ করে
- 1
createTaskটাস্ক তৈরি করুন
আপনার key ও একটি টাস্ক অবজেক্টসহ /createTask-এ POST করুন। আপনি একটি taskId পাবেন। মূল্য তখনই ব্যালেন্স থেকে কাটা হয়।
- 2
getTaskResultফলাফল চেক করুন
প্রায় 5 সেকেন্ড অপেক্ষা করুন, তারপর status ready না হওয়া পর্যন্ত প্রতি 5 সেকেন্ডে /getTaskResult-এ POST করুন।
- 3
solutionউত্তর ব্যবহার করুন
solution থেকে টোকেন বা টেক্সট নিয়ে পেজের ফর্মে দিন। টাস্ক ব্যর্থ হলে চার্জ ব্যালেন্সে ফেরত আসে।
মূল তথ্য
- Base URL
https://unlock-api.com- API key
- 32 অক্ষর, আপনার অ্যাকাউন্ট পেজে। clientKey (JSON) বা key (in.php, res.php) হিসেবে পাঠান।
- ফরম্যাট
- JSON মেথড: JSON body সহ POST। in.php ও res.php: GET বা POST ফর্ম ফিল্ড; JSON উত্তরের জন্য json=1 যোগ করুন।
- সীমা
- প্রতি অ্যাকাউন্টে মিনিটে 1,200 রিকোয়েস্ট, ফলাফল চেক সহ। টাস্ক তৈরির পর প্রায় 5 সেকেন্ড অপেক্ষা করুন, তারপর প্রতি 5 সেকেন্ডে চেক করুন।
- সময়সীমা
- 5 মিনিটের মধ্যে সমাধান না হওয়া টাস্ক ERROR_CAPTCHA_UNSOLVABLE দিয়ে ব্যর্থ হয় এবং তার চার্জ ব্যালেন্সে ফেরত আসে।
- বিলিং
- টাস্ক তৈরির সময় তার মূল্য কাটা হয়। ব্যর্থ টাস্কের টাকা স্বয়ংক্রিয়ভাবে ফেরত আসে।
দ্রুত শুরু
JSON মেথড দিয়ে একটি reCAPTCHA v2 সমাধান করুন। YOUR_API_KEY-এর জায়গায় আপনার key দিন।
import time, requests
API = "https://unlock-api.com"
KEY = "YOUR_API_KEY"
task = requests.post(f"{API}/createTask", json={
"clientKey": KEY,
"task": {
"type": "RecaptchaV2TaskProxyless",
"websiteURL": "https://example.com/login",
"websiteKey": "6LcR_RsTAAAAAFJR_5ZdbQd0SMxL7yIDmSXH1-lo"
}
}).json()
if task["errorId"]:
raise SystemExit(task["errorCode"])
for _ in range(60): # 60 x 5 s = the 5 minute task limit
time.sleep(5)
r = requests.post(f"{API}/getTaskResult", json={"clientKey": KEY, "taskId": task["taskId"]}).json()
if r["errorId"]:
raise SystemExit(f"{r['errorCode']}: {r.get('errorDescription', '')}") # failed tasks are refunded
if r["status"] == "ready":
print(r["solution"]["gRecaptchaResponse"])
break
else:
raise SystemExit("timed out")const API = "https://unlock-api.com";
const KEY = "YOUR_API_KEY";
const post = (path, body) => fetch(API + path, { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify(body) }).then((r) => r.json());
const task = await post("/createTask", {
clientKey: KEY,
task: {
"type": "RecaptchaV2TaskProxyless",
"websiteURL": "https://example.com/login",
"websiteKey": "6LcR_RsTAAAAAFJR_5ZdbQd0SMxL7yIDmSXH1-lo"
},
});
if (task.errorId) throw new Error(task.errorCode);
let solution = null;
for (let n = 0; n < 60 && !solution; n++) { // 60 x 5 s = the 5 minute task limit
await new Promise((r) => setTimeout(r, 5000));
const r = await post("/getTaskResult", { clientKey: KEY, taskId: task.taskId });
if (r.errorId) throw new Error(r.errorCode + ": " + r.errorDescription); // failed tasks are refunded
if (r.status === "ready") solution = r.solution;
}
if (!solution) throw new Error("timed out");
console.log(solution.gRecaptchaResponse);<?php
$api = "https://unlock-api.com";
$key = "YOUR_API_KEY";
function post($url, $body) {
$c = curl_init($url);
curl_setopt_array($c, [CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["Content-Type: application/json"], CURLOPT_POSTFIELDS => json_encode($body)]);
return json_decode(curl_exec($c), true);
}
$task = post("$api/createTask", ["clientKey" => $key, "task" => json_decode('{"type":"RecaptchaV2TaskProxyless","websiteURL":"https://example.com/login","websiteKey":"6LcR_RsTAAAAAFJR_5ZdbQd0SMxL7yIDmSXH1-lo"}', true)]);
if ($task["errorId"]) exit($task["errorCode"]);
for ($n = 0; $n < 60; $n++) { // 60 x 5 s = the 5 minute task limit
sleep(5);
$r = post("$api/getTaskResult", ["clientKey" => $key, "taskId" => $task["taskId"]]);
if ($r["errorId"]) exit($r["errorCode"] . ": " . $r["errorDescription"]); // failed tasks are refunded
if ($r["status"] === "ready") break;
}
if ($r["status"] !== "ready") exit("timed out");
print_r($r["solution"]["gRecaptchaResponse"]);package main
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
"time"
)
const api = "https://unlock-api.com"
const key = "YOUR_API_KEY"
func post(method string, body map[string]any) map[string]any {
b, _ := json.Marshal(body)
res, err := http.Post(api+"/"+method, "application/json", bytes.NewReader(b))
if err != nil {
panic(err)
}
defer res.Body.Close()
var out map[string]any
json.NewDecoder(res.Body).Decode(&out)
return out
}
func main() {
task := post("createTask", map[string]any{
"clientKey": key,
"task": map[string]any{
"type": "RecaptchaV2TaskProxyless",
"websiteURL": "https://example.com/login",
"websiteKey": "6LcR_RsTAAAAAFJR_5ZdbQd0SMxL7yIDmSXH1-lo",
},
})
if task["errorId"].(float64) != 0 {
panic(task["errorCode"])
}
for n := 0; n < 60; n++ { // 60 x 5 s = the 5 minute task limit
time.Sleep(5 * time.Second)
r := post("getTaskResult", map[string]any{"clientKey": key, "taskId": task["taskId"]})
if r["errorId"].(float64) != 0 {
panic(r["errorCode"]) // failed tasks are refunded
}
if r["status"] == "ready" {
fmt.Println(r["solution"])
return
}
}
panic("timed out")
}import java.net.URI;
import java.net.http.*;
import java.util.regex.*;
public class Solve {
static final String API = "https://unlock-api.com", KEY = "YOUR_API_KEY";
static final HttpClient HTTP = HttpClient.newHttpClient();
static String post(String method, String json) throws Exception {
var req = HttpRequest.newBuilder(URI.create(API + "/" + method))
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(json)).build();
return HTTP.send(req, HttpResponse.BodyHandlers.ofString()).body();
}
public static void main(String[] args) throws Exception {
String task = "{\"type\":\"RecaptchaV2TaskProxyless\",\"websiteURL\":\"https://example.com/login\",\"websiteKey\":\"6LcR_RsTAAAAAFJR_5ZdbQd0SMxL7yIDmSXH1-lo\"}";
String created = post("createTask", "{\"clientKey\":\"" + KEY + "\",\"task\":" + task + "}");
Matcher id = Pattern.compile("\"taskId\":(\\d+)").matcher(created);
if (!id.find()) throw new RuntimeException(created);
for (int n = 0; n < 60; n++) { // 60 x 5 s = the 5 minute task limit
Thread.sleep(5000);
String r = post("getTaskResult", "{\"clientKey\":\"" + KEY + "\",\"taskId\":" + id.group(1) + "}");
if (r.contains("\"errorId\":1")) throw new RuntimeException(r); // failed tasks are refunded
if (r.contains("\"status\":\"ready\"")) { System.out.println(r); return; }
}
throw new RuntimeException("timed out");
}
}using System.Net.Http.Json;
using System.Text.Json;
const string Api = "https://unlock-api.com";
const string Key = "YOUR_API_KEY";
var http = new HttpClient();
async Task<JsonElement> Post(string method, object body) =>
await (await http.PostAsJsonAsync($"{Api}/{method}", body)).Content.ReadFromJsonAsync<JsonElement>();
var task = await Post("createTask", new {
clientKey = Key,
task = JsonSerializer.Deserialize<JsonElement>("""
{"type":"RecaptchaV2TaskProxyless","websiteURL":"https://example.com/login","websiteKey":"6LcR_RsTAAAAAFJR_5ZdbQd0SMxL7yIDmSXH1-lo"}
""")
});
if (task.GetProperty("errorId").GetInt32() != 0) throw new Exception(task.GetProperty("errorCode").GetString());
for (var n = 0; n < 60; n++) { // 60 x 5 s = the 5 minute task limit
await Task.Delay(5000);
var r = await Post("getTaskResult", new { clientKey = Key, taskId = task.GetProperty("taskId").GetInt64() });
if (r.GetProperty("errorId").GetInt32() != 0) throw new Exception(r.GetProperty("errorCode").GetString()); // failed tasks are refunded
if (r.GetProperty("status").GetString() == "ready") { Console.WriteLine(r.GetProperty("solution")); return; }
}
throw new Exception("timed out");curl -s https://unlock-api.com/createTask \
-H "Content-Type: application/json" \
-d '{"clientKey":"YOUR_API_KEY","task":{"type":"RecaptchaV2TaskProxyless","websiteURL":"https://example.com/login","websiteKey":"6LcR_RsTAAAAAFJR_5ZdbQd0SMxL7yIDmSXH1-lo"}}'
# {"errorId":0,"taskId":1001}
curl -s https://unlock-api.com/getTaskResult \
-H "Content-Type: application/json" \
-d '{"clientKey":"YOUR_API_KEY","taskId":1001}'
# {"errorId":0,"status":"processing"} then {"errorId":0,"status":"ready","solution":{...},"cost":"0.001"}মেথড
createTaskএকটি টাস্ক তৈরি করে তার id ফেরত দেয়। টাস্ক গৃহীত হলে টাস্ক টাইপের মূল্য ব্যালেন্স থেকে কাটা হয়, আর টাস্ক ব্যর্থ হলে ফেরত দেওয়া হয়।getTaskResultটাস্কের অবস্থা ফেরত দেয়। সমাধান চলাকালীন status থাকে processing। শেষ হলে status হয় ready এবং solution-এ উত্তর থাকে। ব্যর্থ টাস্ক কারণসহ errorId 1 ফেরত দেয়, আর তার চার্জ আগেই ব্যালেন্সে ফেরত এসেছে।getBalanceঅ্যাকাউন্টের ব্যালেন্স US ডলারে ফেরত দেয়।getTokenএকটি টাস্ক তৈরি করে এবং একই রিকোয়েস্টে 50 সেকেন্ড পর্যন্ত উত্তরের জন্য অপেক্ষা করে। এর মধ্যে টাস্ক শেষ না হলে উত্তর হয় status processing সঙ্গে taskId; getTaskResult দিয়ে চেক করতে থাকুন। getToken টাস্কের জন্য ফলাফলের callback পাঠানো হয় না।getQueueStatsবর্তমান কিউ ফেরত দেয়: অপেক্ষমাণ টাস্ক, সমাধান চলা টাস্ক এবং গত এক ঘণ্টার গড় সমাধান সময়। সংখ্যাগুলো আসল টাস্ক থেকে নেওয়া, অনুমান নয়।getSpendingStatsএক UTC দিনের আপনার খরচ ঘণ্টা ধরে ফেরত দেয়: টাস্কের সংখ্যা ও খরচ হওয়া টাকা। ব্যর্থ ও ফেরত দেওয়া টাস্ক গোনা হয় না।reportCorrect, reportIncorrectসঠিক বা ভুল উত্তর রিপোর্ট করুন। পুরোনো লাইব্রেরি যেন চলতে থাকে তাই এই কলগুলো গ্রহণ করা হয়; রিপোর্টে চার্জ বদলায় না।testডিবাগিংয়ের জন্য echo। প্রাপ্ত JSON body clientKey ছাড়া ফেরত দেয়। key যাচাই নেই, চার্জ নেই।
গাইড
- API key ও নিরাপত্তাকীভাবে key পাঠাবেন, একাধিক key ব্যবহার করবেন এবং শুধু নিজের সার্ভারকে অনুমতি দেবেন।
- সীমা, সময় ও বিলিংরিকোয়েস্টের সীমা, কতবার ফলাফল চেক করবেন, সময়সীমা এবং কখন চার্জ নেওয়া হয়।
- এরর কোডপ্রতিটি এরর কোড, তার মানে, কী করবেন এবং চার্জ নেওয়া হয় কি না।
- Proxy ব্যবহারকখন নিজের proxy দিয়ে সমাধান করবেন এবং কীভাবে পাঠাবেন।
- ফলাফলের callbackচেক করার বদলে ফলাফল আপনার সার্ভারে পাঠিয়ে নিন।
- ফর্ম API: in.php ও res.phpক্লাসিক in.php ও res.php রিকোয়েস্ট, পুরোনো সলভার API-এর জন্য লেখা কোডের জন্য।
টাস্ক টাইপ
প্রতিটি টাইপের নিজস্ব পেজ আছে, যেখানে প্রতিটি প্যারামিটার, solution অবজেক্ট ও উদাহরণ রয়েছে।
টোকেন টাস্ক
- reCAPTCHA v2
RecaptchaV2TaskProxylessuserrecaptcha - reCAPTCHA v2 Enterprise
RecaptchaV2EnterpriseTaskProxylessuserrecaptcha, enterprise=1 - reCAPTCHA v3
RecaptchaV3TaskProxylessuserrecaptcha, version=v3 - Cloudflare Turnstile
TurnstileTaskProxylessturnstile - GeeTest v3 / v4
GeeTestTaskProxylessgeetest, geetest_v4 - FunCaptcha (Arkose Labs)
FunCaptchaTaskProxylessfuncaptcha - Amazon AWS WAF
AmazonTaskProxylessamazon_waf - MTCaptcha
MtCaptchaTaskProxylessmt_captcha - Friendly Captcha
FriendlyCaptchaTaskProxylessfriendly_captcha - Lemin Cropped Captcha
LeminTaskProxylesslemin - DataDome
DataDomeSliderTaskdatadome - KeyCaptcha
KeyCaptchaTaskProxylesskeycaptcha - Capy Puzzle
CapyTaskProxylesscapy - Cloudflare Challenge পেজ
AntiCloudflareTaskcloudflare_challenge - Cutcaptcha
CutCaptchaTaskProxylesscutcaptcha - CyberSiARA
AntiCyberSiAraTaskProxylesscybersiara - atbCAPTCHA
AtbCaptchaTaskProxylessatb_captcha - Tencent Captcha
TencentTaskProxylesstencent - Prosopo Procaptcha
ProsopoTaskProxylessprosopo - CaptchaFox
CaptchaFoxTaskProxylesscaptchafox - Altcha
AltchaTaskProxylessaltcha - NetEase Yidun
YidunTaskProxylessyidun - Yandex SmartCaptcha
YandexSmartCaptchaTaskProxylessyandex - VK Captcha
VKCaptchaTaskProxylessvkcaptcha - Binance Captcha
BinanceTaskProxylessbinance - কাস্টম টাস্ক (Imperva, Temu ও অন্যান্য)
CustomTaskincapsula, temuimage, hunt, tspd, basilisk
ছবি ও অডিও টাস্ক
- ছবি থেকে লেখা
ImageToTextTaskpost, base64 - লেখা প্রশ্ন
TextCaptchaTasktextcaptcha - ছবির গ্রিড
GridTaskpost, recaptcha=1 - ক্লিক কোঅর্ডিনেট
CoordinatesTaskpost, coordinatescaptcha=1 - ঘোরানো
RotateTaskrotatecaptcha - অডিও
AudioTaskaudio - বাউন্ডিং বক্স
BoundingBoxTaskbounding_box - চারপাশে আঁকা
DrawAroundTaskpost, canvas=1 - ড্র্যাগ অ্যান্ড ড্রপ
DragAndDropTask- - জটিল ছবির টাস্ক
ComplexImageTask-