YandexSmartCaptchaRecognition
Solve the Yandex SmartCaptcha click challenge from its images and get the click coordinates. Shows the request schema, an example and provider prices.
YandexSmartCaptchaRecognition solves the Yandex SmartCaptcha challenge that asks the visitor to click objects in a given order. You send the main CAPTCHA image and the instruction image, and you get the points to click in solution.coordinates.
For the token flow, use YandexSmartCaptchaToken.
Send the images
imageBase64: the main CAPTCHA image, 320×180, base64-encoded.imgInstructions: the instruction image that shows which objects to click and in what order, 480×180, base64-encoded. Always send it, because the provider cannot tell the order without it.comment: optional text hint, for exampleselect objects in the order of the instruction.
Send each image as plain base64 or as a data: URI. The data URI prefix is removed for you.
Click the points
solution.coordinates lists the points to click, in order. Each point has x and y, measured from the top-left corner of the main image. Click them in the order returned, then submit the challenge the way a user would.
Check Provider stats for live success rates and solve times before you pick a provider.
Supported Providers
Request Schema
| Field | Type | Required | Description |
|---|---|---|---|
clientKey* | string | Yes | Your API key. Create one in a workspace of the AnySolver dashboard. Example: |
task* | object | Yes | The task body. Required fields depend on the task type. See Tasks for per-task schemas. View task properties |
settings | object | No | Per-request settings for routing, Auto Retry, Auto Fallback, proxy reuse, response statistics and detailed analytics. Each field overrides the API key's value. See Routing modes. View settings reference |
Task Object Properties
The task field accepts an object with the following properties:
| Field | Type | Required | Description |
|---|---|---|---|
type* | Yes | ||
imageBase64* | string | Yes | Base64-encoded main captcha image (320×180) to solve with click coordinates. Example: |
imgInstructions* | string | Yes | Base64-encoded instruction image (480×180) showing which objects to click, and in which order. Example: |
comment | string | No | Text hint for the worker, for example Example: |
{
"clientKey": "YOUR_API_KEY",
"task": {
"type": "YandexSmartCaptchaRecognition",
"imageBase64": "iVBORw0KGgoAAAANSUhEUgAA...",
"imgInstructions": "iVBORw0KGgoAAAANSUhEUgAA...instructions"
}
}Optional fields are not guaranteed across providers
Response Schema
| Field | Type | Required | Description |
|---|---|---|---|
status* | Yes | Task status: "processing", "ready", or "failed". Example: | |
errorId* | Yes |
Example: | |
taskId | string | No | Unique identifier returned when the task was created. Example: |
errorCode | No | Machine-readable error code. Example: | |
errorDescription | string | No | Human-readable error message with resolution hints. Example: |
cost | number | No | Actual cost charged for this task in USD. Example: |
taskType | No | The type of CAPTCHA task to solve. Example: | |
provider | No | Provider that handled this task. While processing, the provider currently solving it. Example: | |
solution | object | No |
Solution Object Properties
The solution field contains an object with the following properties:
| Field | Type | Required | Description |
|---|---|---|---|
coordinates* | object[] | Yes | Points to click, in order, relative to the top-left corner of the image. Example: |
raw* | Record<string, unknown> | Yes | Raw provider response data for advanced use cases. |