TikTok Captchas
Routes related to TikTok Captchas.
Retrieve captcha credits
Retrieve the rate limits for the provided API key.
This route is deprecated as CAPTCHAs are no longer billed for usage.
Responses
Response Attributes
Complete whirl captcha
The whirl captcha requires two images: the outer image and the inner image.
Example Image
Usage
The solution to the whirl captcha is an angle from 0-360. To use it in the GUI, it must be converted to a slider distance:
px = ((sidebar_length - icon_length) * angle) / 360
sidebar_lengthis the width of.captcha_verify_slide--slidebaricon_lengthis the width of.secsdk-captcha-drag-icon
Request Body
RequiredThe outer image file
The inner image file
Responses
Response Attributes
Complete shapes captcha
The shapes captcha requires just one image.
Example Image
Usage
The solution to the shapes captcha are two points that need to be clicked. To use it in the GUI, convert the proportions to pixel values based on the image size.
The points are returned as x and y proportions (0-1) of the width and height of the source image.
The captcha image selector is .captcha-verify-image
Request Body
RequiredThe uploaded image file
Responses
Response Attributes
Complete puzzle captcha
The puzzle captcha requires two images
Example Image
Usage
The solution to the puzzle captcha is the distance to move the slider to fit the puzzle piece into the background.
The backgroundImage is the full background image with the missing piece.
The pieceImage is the small puzzle piece that needs to be fit into the background.
The captcha image selectors are:
- Background:
.captcha-verify-image - Piece:
#captcha-verify-image ~ div.cap-absolute > img
The solution is the x proportion (0-1) of the width of the background image where the piece fits. It is 1:1 with the slider distance proportion.
Request Body
RequiredThe uploaded background image file
The uploaded puzzle piece image file
Responses
Response Attributes
Complete icon captcha
The icons captcha requires just one image & a prompt string.
Example Image
Usage
The prompt is the text prompt provided by TikTok. The Icon captcha solution is provided as a list of points, where each point marks a location on the image that needs to be clicked.
These points are expressed as ratios relative to the image's width and height.
A point of (0.0, 0.0) corresponds to the image’s upper-left corner, while (1.0, 1.0) represents the lower-right corner. For reference, (0.5, 0.5) sits at the exact center.
The captcha image selector is .captcha-verify-image
Query Parameters
Request Body
RequiredThe uploaded image file
Responses
Response Attributes