Skip to content

TikTok Captcha Solver

Solve TikTok challenges by providing base64-encoded images. The API uses TiktokClassification with a question field to distinguish between challenge types.

Supported Modes

ModequestionInputResponse
WhirlwhirlBackground + puzzle pieceRotation angle number[]
GridgridBackground + slider imagesGrid indices number[]
ClickclickBackground imageClick coordinates

Create Task β€” Whirl (Rotation)

Send the background image in queries and the puzzle piece in examples.

POST/createTask
Hostapi.captchasonic.com
Content-Typeapplication/json
{
    "apiKey": "YOUR_API_KEY",
    "task": {
        "type": "TiktokClassification",
        "question": "whirl",
        "queries": ["BASE64_BACKGROUND_IMAGE"],
        "examples": ["BASE64_PUZZLE_PIECE"]
    }
}

Response

{
    "code": 200,
    "msg": "",
    "answers": [[142.5]]
}

Create Task β€” Grid

Send grid images in queries.

{
    "apiKey": "YOUR_API_KEY",
    "task": {
        "type": "TiktokClassification",
        "question": "grid",
        "queries": ["BASE64_BG", "BASE64_SLIDER"]
    }
}

Response

{
    "code": 200,
    "msg": "",
    "answers": [2, 5]
}

Task Parameters

PropertyTypeRequiredDescription
typestringβœ…TiktokClassification
questionstringβœ…whirl, grid, or click
queriesstring[]βœ…Base64-encoded images
examplesstring[]Whirl onlyPuzzle piece image(s) for rotation tasks

API Playground

POST
Log in to auto-fill your API key
Payload
Response

Hit Send to see response

⌘ + Enter

Parameters

apiKeystringYOUR_API_KEY
taskobject{...}
β”” typestringTiktokClassification
β”” questionstringwhirl
β”” queriesarray[1 items]
β”” examplesarray[1 items]

Error Codes

1KEY_DOES_NOT_EXIST
2NO_SLOT_AVAILABLE
3ZERO_BALANCE
10ERROR_BAD_PARAMETERS
12ERROR_CAPTCHA_UNSOLVABLE
14PLAN_EXPIRED
16RATE_LIMITED
17DAILY_LIMIT_EXCEEDED
18QUOTA_LIMIT_EXCEEDED
21SERVICE_UNAVAILABLE
Code
terminal