YesCaptcha

https://yescaptcha.atlassian.net/wiki/spaces/YESCAPTCHA/
Admin
YesCaptcha is a CAPTCHA solving service that provides APIs for automated captcha recognition and...
Tokens:46,764
Snippets:203
Trust Score:10
Update:1 day ago
Show doc for...
Tokens:
Raw
### Get Task Result Response Example

Source: https://yescaptcha.atlassian.net/wiki/spaces/YESCAPTCHA/pages/64193447/TurnstileTaskProxyless+Cloudflare+Turnstile+protocol+interface

Example response from the getTaskResult method when the task is ready. The solution contains the token and userAgent.

```json
{ "errorId": 0, "errorCode": null, "errorDescription": null, "solution": { "token": "0.ufq5RgSVZd11DPSX1brdrxnEs28KcVlKj2ORchqxSy2q9yAW6ciq3hriXDF4x……", "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/107.0.0.0 Safari/537.36", }, "status": "ready" }
```

--------------------------------

### Response Example

Source: https://yescaptcha.atlassian.net/wiki/spaces/YESCAPTCHA/pages/64192677/createTask+captcha+task+creating

Example JSON response from the createTask endpoint. The 'taskId' field should be recorded for future use in the getTaskResult method.

```json
{ "errorId": 0, "errorCode": "", "errorDescription": "", "taskId": "2376919c-1863-11ec-a012-94e6f7355a0b" // Please record this ID for future use in the subsequent steps. }
```

--------------------------------

### Get task result response example

Source: https://yescaptcha.atlassian.net/wiki/spaces/YESCAPTCHA/pages/64192939

JSON response from the getTaskResult method. When status is 'ready', the solution contains the gRecaptchaResponse value, which is valid for 120 seconds and recommended for use within 60 seconds.

```json
{ "errorId": 0, "errorCode": null, "errorDescription": null, "solution": { "gRecaptchaResponse": "03AGdBq25SxXT-pmSeBXjzScW-EiocHwwpwqtk1QXlJnGnU......" }, "status": "ready" }
```

--------------------------------

### Get task result response example

Source: https://yescaptcha.atlassian.net/wiki/spaces/YESCAPTCHA/pages/389382145/CloudFlareTask+CloudFlare5S

Response from the getTaskResult method when the task is ready. Contains the solution object with user_agent, cookies, request_headers, headers, and content. Note the typo 'heders' in the example.

```json
{ "errorId": 0, "status": "ready" "solution": { "cf": true, "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.4 Safari/605.1.15", "cookies": { "cf_clearance": "zqKrlel6E6_SM2707VdArsu2c5.bYqLKU3DOl4tlkCE-1691687641-0-1-8d7f630c.c91f3e0f.da7e3cec-250.0.0" }, "heders": { "accept-ch": "Sec-CH-UA-Bitness, Sec-CH-UA-Arch, Sec-CH-UA-Full-Version, Sec-CH-UA-Mobile, Sec-CH-UA-Model, Sec-CH-UA-Platform-Version, Sec-CH-UA-Full-Version-List, Sec-CH-UA-Platform, Sec-CH-UA, UA-Bitness, UA-Arch, UA-Full-Version, UA-Mobile, UA-Model, UA-Platform-Version, UA-Platform, UA", "server": "cloudflare", "vary": "Accept-Encoding", "x-frame-options": "SAMEORIGIN" }, "request_headers": { ":authority": "raffle.bstn.com", ":method": "GET", ":path": "/", ":scheme": "https", "accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7", "accept-encoding": "gzip, deflate, br", "accept-language": "zh-CN,zh;q=0.9", "upgrade-insecure-requests": "1", "user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36" }, "content": "<!DOCTYPE html><html lang=\"en\"><head>\n <!-- Required meta tags -->\n <meta charset=\"utf-8\">\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">\n \n <meta name=\"theme-color\" content=\"#7952b3\">\n <!-- Bootstrap CSS -->\n <link href=\"https://cdn.jsdelivr.net/npm/bootstrap@5.0.1/dist/css/bootstrap.min.css\" rel=\"stylesheet\" 
```

--------------------------------

### Response example for ImageToTextTask

Source: https://yescaptcha.atlassian.net/wiki/spaces/YESCAPTCHA/pages/64192889/ImageToTextTask+English+and+numeric+characters+in+images+with+varying+lengths

Example JSON response from the recognition task. Contains errorId, status, solution with recognized text, and taskId for asynchronous tasks.

```json
{ "errorId": 0, "errorCode": "", "errorDescription": "", "status": "ready", "solution": { "text": "44795" }, "taskId": "2376919c-1863-11ec-a012-94e6f7355a0b" }
```

--------------------------------

### Solution for 1x1 Image (100x100)

Source: https://yescaptcha.atlassian.net/wiki/spaces/YESCAPTCHA/pages/64193026/ReCaptchaV2Classification+reCaptcha+V2+image+recognition

Example solution for a 1x1 image (100x100) with 2 points. The hasObject field indicates whether clicking is required.

```json
"solution": { "hasObject": true / false, // To determine whether an object is the target object "type": "single" }
```

--------------------------------

### Solution for 3x3 Image (300x300)

Source: https://yescaptcha.atlassian.net/wiki/spaces/YESCAPTCHA/pages/64193026/ReCaptchaV2Classification+reCaptcha+V2+image+recognition

Example solution for a 3x3 image (300x300) with 8 points. The objects array contains indices of positions to click.

```json
"solution": { "objects": [0,2,6], // The position where the image needs to be clicked. "type": "multi" }
```

--------------------------------

### Response Example for ReCaptchaV2Classification

Source: https://yescaptcha.atlassian.net/wiki/spaces/YESCAPTCHA/pages/64193026/ReCaptchaV2Classification+reCaptcha+V2+image+recognition

Example response from the createTask method. The solution contains an objects array with positions to click and a type field. The errorId 0 indicates success.

```json
{ "errorId": 0, "errorCode": "", "errorDescription": "null", "status": "ready", "taskId": "3a9e8cb8-3871-11ec-9794-94e6f7355a0b", "solution": { "objects": [1,5,8], // The position where the image needs to be clicked. "type": "multi" } }
```

--------------------------------

### Cloudflare 5s challenge response example

Source: https://yescaptcha.atlassian.net/wiki/spaces/YESCAPTCHA/pages/389382145/CloudFlareTask+CloudFlare5S

Example response from the Cloudflare challenge, containing JavaScript that sets a cookie and loads an invisible challenge script. Use the returned `ua`, `cookie`, and proxy IP for subsequent requests as Cloudflare requires them to be consistent.

```html
"window['__CF$cv$params']={r:'7f49dfe16af64c78',t:'MTY5MTY4NzY1OS44MjgwMDA='};_cpo=document.createElement('script');_cpo.nonce='',_cpo.src='/cdn-cgi/challenge-platform/scripts/invisible.js',document.getElementsByTagName('head')[0].appendChild(_cpo);";var _0xh = document.createElement('iframe');_0xh.height = 1;_0xh.width = 1;_0xh.style.position = 'absolute';_0xh.style.top = 0;_0xh.style.left = 0;_0xh.style.border = 'none';_0xh.style.visibility = 'hidden';document.body.appendChild(_0xh);function handler() {var _0xi = _0xh.contentDocument || _0xh.contentWindow.document;if (_0xi) {var _0xj = _0xi.createElement('script');_0xj.innerHTML = js;_0xi.getElementsByTagName('head')[0].appendChild(_0xj);}}if (document.readyState !== 'loading') {handler();} else if (window.addEventListener) {document.addEventListener('DOMContentLoaded', handler);} else {var prev = document.onreadystatechange || function () {};document.onreadystatechange = function (e) {prev(e);if (document.readyState !== 'loading') {document.onreadystatechange = prev;handler();}};}})();</script><iframe height="1" width="1" style="position: absolute; top: 0px; left: 0px; border: none; visibility: hidden;"></iframe>
</body></html>
```

--------------------------------

### Solution for 4x4 Image (450x450)

Source: https://yescaptcha.atlassian.net/wiki/spaces/YESCAPTCHA/pages/64193026/ReCaptchaV2Classification+reCaptcha+V2+image+recognition

Example solution for a 4x4 image (450x450) with 8 points. The objects array contains indices from 0 to 15.

```json
"solution": { "objects": [9, 10, 11, 13, 14, 15], // The position where the image needs to be clicked ranges from 0 to 15. "type": "multi" }
```

--------------------------------

### Create Task Request Example

Source: https://yescaptcha.atlassian.net/wiki/spaces/YESCAPTCHA/pages/64193447/TurnstileTaskProxyless+Cloudflare+Turnstile+protocol+interface

Example JSON payload for creating a TurnstileTaskProxyless task. The clientKey is your API key, and the task object contains the task type, websiteURL, and websiteKey.

```json
{ "clientKey":"cc9c18d3e263515c2c072b36a7125eecc078618f", "task": { "type":"TurnstileTaskProxyless", "websiteURL":"https://react-turnstile.vercel.app", "websiteKey":"1x00000000000000000000AA" } }
```

--------------------------------

### C# YesCaptcha API Integration Example

Source: https://yescaptcha.atlassian.net/wiki/spaces/YESCAPTCHA/pages/64194653/English+C+DEMO+demo_c+.cs

This snippet shows a complete C# example for interacting with the YesCaptcha API. It includes a method to send a POST request with form data, entity classes for creating tasks and retrieving results, and a helper class for JSON serialization using DataContractJsonSerializer. The code is from the file demo_c#.cs and is intended for use in a .NET environment.

```csharp
try { // 设置参数 request = WebRequest.Create(posturl) as HttpWebRequest; CookieContainer cookieContainer = new CookieContainer(); request.CookieContainer = cookieContainer; request.AllowAutoRedirect = true; request.Method = "POST"; request.ContentType = "application/x-www-form-urlencoded"; request.ContentLength = data.Length; outstream = request.GetRequestStream(); outstream.Write(data, 0, data.Length); outstream.Close(); //发送请求并获取相应回应数据 response = request.GetResponse() as HttpWebResponse; //直到request.GetResponse()程序才开始向目标网页发送Post请求 instream = response.GetResponseStream(); sr = new StreamReader(instream, encoding); //返回结果网页（html）代码 string content = sr.ReadToEnd(); string err = string.Empty; return content; } catch (Exception ex) { string err = ex.Message; return string.Empty; } } } /// <summary> /// CreateTask实体类 /// </summary> public class YesCreateTsak { public string errorId { get; set; } public string errorCode { get; set; } public string errorDescription { get; set; } public string taskId { get; set; } } /// <summary> /// GetTaskResult实体类 /// </summary> public class YesGetTaskResult { public int errorId { get; set; } public string errorCode { get; set; } public string errorDescription { get; set; } public string status { get; set; } public solution solution { get; set; } } /// <summary> /// solution实体类 /// </summary> public class solution { public string gRecaptchaResponse { get; set; } } /// <summary> /// 序列化 /// </summary> public class SerializeHelper { //System.Web.Script.Serialization.JavaScriptSerializer serializer = new System.Web.Script.Serialization.JavaScriptSerializer(); public readonly static SerializeHelper Instance = new SerializeHelper(); /// <summary> /// 将C#数据实体转化为JSON数据 /// </summary> /// <param name="obj">要转化的数据实体</param> /// <returns>JSON格式字符串</returns> public string JsonSerialize<T>(T obj) { DataContractJsonSerializer serializer = new DataContractJsonSerializer(typeof(T)); MemoryStream stream = new MemoryStream(); serializer.WriteObject(stream, obj); stream.Position = 0; StreamReader sr = new StreamReader(stream); string resultStr = sr.ReadToEnd(); sr.Close(); stream.Close(); return resultStr; } /// <summary> /// 将JSON数据转化为C#数据实体 /// </summary> /// <param name="json">符合JSON格式的字符串</param> /// <returns>T类型的对象</returns> public T JsonDeserialize<T>(string json) { DataContractJsonSerializer serializer = new DataContractJsonSerializer(typeof(T)); MemoryStream ms = new MemoryStream(System.Text.Encoding.UTF8.GetBytes(json.ToCharArray())); T obj = (T)serializer.ReadObject(ms); ms.Close(); return obj; } } }
```

--------------------------------

### Create Task Request Example

Source: https://yescaptcha.atlassian.net/wiki/spaces/YESCAPTCHA/pages/64192910/NoCaptchaTaskProxyless+reCaptcha+V2+protocol+interface

JSON payload for creating a NoCaptchaTaskProxyless task. The isInvisible parameter is optional and only needed for invisible reCaptcha. The clientKey is your API key.

```json
{
  "clientKey": "cc9c18d3e263515c2c072b36a7125eecc078618f",
  "task": {
    "websiteURL": "https://www.google.com/recaptcha/api2/demo",
    "websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
    "type": "NoCaptchaTaskProxyless",
    "isInvisible": false // You only need to add the true value if the reCaptcha type is isInvisible.
  }
}
```

--------------------------------

### Get task result request example

Source: https://yescaptcha.atlassian.net/wiki/spaces/YESCAPTCHA/pages/389382145/CloudFlareTask+CloudFlare5S

JSON payload for the getTaskResult method to retrieve the recognition result using the clientKey and taskId obtained from the createTask response.

```json
{ "clientKey":"cc9c18d3e263515c2c072b36a7125eecc078618f3", "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006" }
```

--------------------------------

### curl_cffi example for bypassing TLS fingerprint

Source: https://yescaptcha.atlassian.net/wiki/spaces/YESCAPTCHA/pages/389382145/CloudFlareTask+CloudFlare5S

Python example using `curl_cffi.requests` with `impersonate="chrome110"` to simulate a Chrome browser fingerprint and bypass TLS fingerprint blocking. The example shows a normal request returning 403 with 'Just a moment...' and the impersonated request returning 200.

```python
from curl_cffi import requests
proxies = {
    'http': "http://127.0.0.1:10911",
    'https': "http://127.0.0.1:10911",
}
# 正常情况是这样的
response = requests.get("https://apkpure.com/", proxies=proxies)
print("请求响应：", response.status_code)
print("网页标题：", response.text[:63])
# 返回：
# 请求响应： 403
# 网页标题： <!DOCTYPE html><html lang="en-US"><head><title>Just a moment...
# 使用 curl_cffi.requests请求
# impersonate参数指定了模拟Chrome浏览器的指纹
response = requests.get(
    "https://apkpure.com/",
    proxies=proxies,
    impersonate="chrome110")
print("请求响应：", response.status_code)
print("网页标题：", response.text[:63])
# 返回：
# 请求响应： 200
# 网页标题： <!DOCTYPE html><html lang="en"><head><title>Download APK on And
```

--------------------------------

### Request example for ImageToTextTask

Source: https://yescaptcha.atlassian.net/wiki/spaces/YESCAPTCHA/pages/64192889/ImageToTextTask+English+and+numeric+characters+in+images+with+varying+lengths

Example JSON payload for creating a recognition task with the ImageToTextTaskMuggle type. The body field must be base64 encoded without line breaks and without the data:image prefix.

```json
{ "clientKey":"cc9c18d3e263515c2c072b36a7125eecc078618f", "task": { "type":"ImageToTextTaskMuggle", "body": "/9j/4AAQSkZJRgABA......" # BASE64_BODY_HERE } }
```

--------------------------------

### Create CloudFlareTaskS2 task request example

Source: https://yescaptcha.atlassian.net/wiki/spaces/YESCAPTCHA/pages/389382145/CloudFlareTask+CloudFlare5S

JSON payload for the createTask method to initiate a CloudFlareTaskS2 recognition task. Includes clientKey, task type, websiteURL, proxy, waitLoad, and requiredCookies. The proxy is a demo and should be replaced with your own.

```json
{ "clientKey": "cc9c18d3e263515c2c072b36a7125eecc078618f", "task": { "type": "CloudFlareTaskS2", "websiteURL": "https://nowsecure.in", "proxy": "http://JN3wWChA:Dsg7ckfv@45.91.239.47:62930", //请用你自己的代理，这个只是演示 "waitLoad": false, // 是否需要等待加载完成（如果你需要完整内容就写true，会增加识别时间） "requiredCookies": ["cf_clearance"] // 可以要求获取指定Cookies名称，可不填，不一定能获取到 } }
```

--------------------------------

### getTaskResult

Source: https://yescaptcha.atlassian.net/wiki/spaces/YESCAPTCHA/pages/64192619

Gets the recognition result.

```APIDOC
## getTaskResult

### Description
Get recognition result.

### Method
Not specified in source.

### Endpoint
Not specified in source.

### Parameters
None documented.

### Request Example
Not specified in source.

### Response
Not specified in source.

### Response Example
Not specified in source.
```
Tokens:
Raw