TiktokSelectObjectWebTask

Picking 2 objects on the web is a common captcha type on TikTok.

Tiktok select object modal — Example of the 'Pick 2 objects with the same shape' TikTok captcha

1. Create the task

Request

POST https://api.omocaptcha.com/v2/createTask

Parameter	Type	Required	Description
`clientKey`	String	✅	Your client API key
`task.type`	String	✅	Captcha service class name — `TiktokSelectObjectWebTask`
`task.imageBase64`	String	✅	Base64-encoded challenge image
`task.widthView`	Number	✅	Rendered image width on the web (px)
`task.heightView`	Number	✅	Rendered image height on the web (px)
`task.question`	String	✅	Captcha question (e.g. `Which of these objects are used in hoops?`)

widthView and heightView are the image dimensions as rendered on the page (not the original image size). Right-click the image → Inspect element to read the correct values.

curl -X POST https://api.omocaptcha.com/v2/createTask \
  -H "Content-Type: application/json" \
  -d '{
    "clientKey": "OMO_API_KEY",
    "task": {
      "type": "TiktokSelectObjectWebTask",
      "imageBase64": "BASE64_BODY_HERE",
      "widthView": 340,
      "heightView": 212,
      "question": "Which of these objects.?"
    }
  }'

const axios = require("axios");

const { data } = await axios.post("https://api.omocaptcha.com/v2/createTask", {
  clientKey: "OMO_API_KEY",
  task: {
    type: "TiktokSelectObjectWebTask",
    imageBase64: "BASE64_BODY_HERE",
    widthView: 340,
    heightView: 212,
    question: "Which of these objects.?",
  },
});

console.log(data);

import requests

resp = requests.post(
    "https://api.omocaptcha.com/v2/createTask",
    json={
        "clientKey": "OMO_API_KEY",
        "task": {
            "type": "TiktokSelectObjectWebTask",
            "imageBase64": "BASE64_BODY_HERE",
            "widthView": 340,
            "heightView": 212,
            "question": "Which of these objects.?",
        },
    },
)
print(resp.json())

<?php
$payload = [
    "clientKey" => "OMO_API_KEY",
    "task" => [
        "type"        => "TiktokSelectObjectWebTask",
        "imageBase64" => "BASE64_BODY_HERE",
        "widthView"   => 340,
        "heightView"  => 212,
        "question"    => "Which of these objects.?",
    ],
];

$ch = curl_init("https://api.omocaptcha.com/v2/createTask");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => ["Content-Type: application/json"],
    CURLOPT_POSTFIELDS     => json_encode($payload),
]);
echo curl_exec($ch);
curl_close($ch);

Response

Success:

{
  "errorId": 0,
  "taskId": "49f9f60a-c809-4af0-93c0-0409b72e67e0"
}

The server returns errorId = 0 with a taskId when the task is created successfully. Failure:

{
  "errorId": 1,
  "errorCode": "",
  "errorDescription": ""
}

The server returns errorId = 1 and the corresponding errorCode.

2. Get the result

Request

POST https://api.omocaptcha.com/v2/getTaskResult

{
  "clientKey": "OMO_API_KEY",
  "taskId": "49f9f60a-c809-4af0-93c0-0409b72e67e0"
}

Response

Success:

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "pointA": { "x": 50, "y": 30 },
    "pointB": { "x": 100, "y": 70 }
  }
}

The server returns errorId = 0 and status = ready. Read the two click points from solution.pointA and solution.pointB.

x and y are given in the rendered image coordinate system (based on widthView × heightView). Click those two points and then press Confirm.

Processing:

{
  "status": "processing",
  "errorId": 0,
  "errorCode": "",
  "errorDescription": ""
}

The server returns errorId = 0 and status = processing. Wait 2 seconds and poll again. Failure:

{
  "errorId": 1,
  "errorCode": "ERROR_JOB_STATUS",
  "errorDescription": "Job failed",
  "status": "fail",
  "solution": {}
}

The server returns errorId = 1 — see Error Codes for handling.

API Reference

Guides

TiktokSelectObjectWebTask

1. Create the task

Request

Response

2. Get the result

Request

Response

​1. Create the task

​Request

​Response

​2. Get the result

​Request

​Response

1. Create the task

Request

Response

2. Get the result

Request

Response