CaptchaFox

시작하기

JSON 방식 메서드

가이드

토큰 작업

이미지·오디오 작업

Markdown OpenAPI

CaptchaFox

createTask나 in.php로 UNLOCK API에 CaptchaFox 작업을 보내는 방법이에요. 작업 종류 이름, 모든 항목, solution 객체, 프록시 항목, 7개 언어 코드 예시를 담았어요.

가격: $0.725 1건당 $0.000725
보내는 것: 페이지 주소와 CaptchaFox 사이트 키
받는 것: CaptchaFox 칸에 넣을 토큰

소개와 가격

작업 종류 이름

프록시 없이 풀려면 첫 번째 이름을 쓰세요. 내 프록시로 풀려면 두 번째 이름을 쓰고 프록시 항목을 더하세요. 가격은 같아요.

CaptchaFoxTaskProxyless프록시 없이

CaptchaFoxTask내 프록시 사용

task 객체

type

String필수

작업 종류 이름이에요. 대소문자는 가리지 않아요. CaptchaFoxTaskProxyless | CaptchaFoxTask

websiteURL

String필수

캡차가 나오는 페이지의 전체 주소예요. http:// 또는 https://로 시작해요.

websiteKey

String필수

캡차 위젯의 사이트 키예요. 페이지 소스에 있어요(예: data-sitekey).

userAgent

String선택

풀 때 쓸 브라우저 User-Agent예요. 답을 낼 때도 같은 값을 보내세요.

여기 없는 항목은 보낸 그대로 풀이 쪽에 넘겨요.

프록시 항목

프록시용 종류 이름일 때만 써요. 항목을 따로 보내거나 proxy 문자열 하나로 보내세요.

proxyType

String필수

http, https, socks4, socks5 중 하나예요.

proxyAddress

String필수

프록시 IP 주소나 호스트 이름이에요.

proxyPort

Integer필수

프록시 포트예요.

proxyLogin

String선택

프록시 사용자 이름이에요. 프록시가 요구할 때만 넣어요.

proxyPassword

String선택

프록시 비밀번호예요. 프록시가 요구할 때만 넣어요.

proxy

String

프록시 항목 전부를 문자열 하나로 넣어요. 예: http://user:pass@1.2.3.4:8080.

프록시 쓰기

요청

POST /createTask

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "CaptchaFoxTaskProxyless",
    "websiteURL": "https://example.com/login",
    "websiteKey": "5EZVvsHMrKCFKp5NYNoTyDjTjetoVo1Z4UNNbTwJf1GfN6Xm"
  }
}

solution 객체

status가 ready일 때 solution에 담겨 와요.

token

String

페이지 양식과 함께 낼 토큰이에요.

POST /getTaskResult

{
  "errorId": 0,
  "taskId": 1001,
  "status": "ready",
  "solution": {
    "token": "4zT2kRBQ8F0mJ6s..."
  },
  "cost": "0.000725",
  "createTime": 1791640000,
  "endTime": 1791640014,
  "solveCount": 1
}

코드 예시

import time, requests

API = "https://unlock-api.com"
KEY = "YOUR_API_KEY"

task = requests.post(f"{API}/createTask", json={
    "clientKey": KEY,
    "task": {
      "type": "CaptchaFoxTaskProxyless",
      "websiteURL": "https://example.com/login",
      "websiteKey": "5EZVvsHMrKCFKp5NYNoTyDjTjetoVo1Z4UNNbTwJf1GfN6Xm"
    }
}).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"]["token"])
        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": "CaptchaFoxTaskProxyless",
    "websiteURL": "https://example.com/login",
    "websiteKey": "5EZVvsHMrKCFKp5NYNoTyDjTjetoVo1Z4UNNbTwJf1GfN6Xm"
  },
});
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.token);

<?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":"CaptchaFoxTaskProxyless","websiteURL":"https://example.com/login","websiteKey":"5EZVvsHMrKCFKp5NYNoTyDjTjetoVo1Z4UNNbTwJf1GfN6Xm"}', 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"]["token"]);

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": "CaptchaFoxTaskProxyless",
			"websiteURL": "https://example.com/login",
			"websiteKey": "5EZVvsHMrKCFKp5NYNoTyDjTjetoVo1Z4UNNbTwJf1GfN6Xm",
		},
	})
	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\":\"CaptchaFoxTaskProxyless\",\"websiteURL\":\"https://example.com/login\",\"websiteKey\":\"5EZVvsHMrKCFKp5NYNoTyDjTjetoVo1Z4UNNbTwJf1GfN6Xm\"}";
    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":"CaptchaFoxTaskProxyless","websiteURL":"https://example.com/login","websiteKey":"5EZVvsHMrKCFKp5NYNoTyDjTjetoVo1Z4UNNbTwJf1GfN6Xm"}
        """)
});
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":"CaptchaFoxTaskProxyless","websiteURL":"https://example.com/login","websiteKey":"5EZVvsHMrKCFKp5NYNoTyDjTjetoVo1Z4UNNbTwJf1GfN6Xm"}}'
# {"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"}

in.php 폼 방식

같은 작업을 예전 폼 요청으로 보내는 방법이에요. res.php가 답을 글자로 돌려줘요.

in.php, res.php

curl -s "https://unlock-api.com/in.php" -d "key=YOUR_API_KEY&method=captchafox&sitekey=SITE_KEY&pageurl=https://example.com/login&json=1"
# {"status":1,"request":"1001"}

curl -s "https://unlock-api.com/res.php?key=YOUR_API_KEY&action=get&id=1001&json=1"
# {"status":0,"request":"CAPCHA_NOT_READY"}  then  {"status":1,"request":"ANSWER"}

폼 API: in.php와 res.php

CaptchaFox

작업 종류 이름

task 객체

프록시 항목

요청

solution 객체

코드 예시

in.php 폼 방식

계정 토큰으로 로그인

계정 토큰으로 로그인