YandexSmartCaptchaToken
Solve Yandex SmartCaptcha through your own proxy and get the smart-token. Covers the request schema, an example and each provider's price per 1,000.
YandexSmartCaptchaToken solves Yandex SmartCaptcha through your proxy from the page URL and the client key, and returns the token. SmartCaptcha is a CAPTCHA service in Yandex Cloud. Its widget also comes as an invisible CAPTCHA that shows a challenge only to suspicious requests.
When the site accepts a token solved from another address, use YandexSmartCaptchaTokenProxyLess. For the image challenges, see YandexSmartCaptchaRecognition and YandexSmartCaptchaPuzzleRecognition.
Use your proxy
task.proxy is required on this task type, and the provider solves from that address. The proxy must keep one IP for the whole solve: see Keep the same IP for the whole solve. Submit the token from the same address.
Find the parameters
websiteKeyis the client key. It is thedata-sitekeyattribute of the element with thesmart-captchaclass, or thesitekeypassed to the widget's JavaScript API.websiteURLis the page that shows the widget.userAgentandcookiesare optional. Send the User-Agent of your browser and cookies in thename1=value1;name2=value2format when the site needs them.
Use the token
The solution token is the value the widget stores in the hidden smart-token input, which the site sends to Yandex for validation. Send it in the form field or callback the page uses.
Per Yandex's validation guide, a token is valid for five minutes and can be validated once. Create the task right before you use the token. If the site rejects it, check that the proxy kept one IP for the whole solve, then that websiteKey and websiteURL come from the page that shows the widget.
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 | ||
websiteURL* | URL | Yes | Full URL of the page where the CAPTCHA is displayed. Example: |
websiteKey* | string | Yes | The client key: the Example: |
proxy* | string | object | Yes | Proxy the provider solves through, as a string or an object. See Proxy configuration. View proxy configurationExample: |
userAgent | string | No | Browser User-Agent string. Must match the browser used on the target page. Not all providers properly support this parameter. Verify the compatibility with the provider you are using. Example: |
cookies | string | No | Cookies to send while solving, in the format Example: |
{
"clientKey": "YOUR_API_KEY",
"task": {
"type": "YandexSmartCaptchaToken",
"websiteURL": "https://example.com/",
"websiteKey": "Y5Lh0ti...",
"proxy": "http://user:pass@1.2.3.4:8080"
}
}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 |
|---|---|---|---|
token* | string | Yes | The solved CAPTCHA token to submit with your form. Example: |
raw* | Record<string, unknown> | Yes | Raw provider response data for advanced use cases. |