Captcha solver API

reCAPTCHA Enterprise

reCAPTCHA Enterprise is the latest type of CAPTCHA from Google, combining the capabilities of V2 and V3. It also allows website administrators to inform Google about whether they believe the user interacting with the site after solving the CAPTCHA is a bot or a human.

How to Use Our Service to Solve reCAPTCHA Enterprise

1. Identify the sitekey and other parameters. Depending on the CAPTCHA configuration on the website, it may include an action parameter, similar to V3, and may also require a min_score.
2. Send an HTTP GET or POST request to our API at:
   https://api.solvecaptcha.com/in.php

   Example URL request:

   https://api.solvecaptcha.com/in.php?key=1abc234de56fab7c89012d34e56fa7b8&method=userrecaptcha&googlekey=6LfD3PIbAAAAAJs_eEHvoOl75_83eXSqpPSRFJ_u&pageurl=https://example.com/page/with/recaptcha-v2-enterprise&enterprise=1&action=verify&json=1

   A full list of request parameters can be found in the table below.

   Code examples for submitting reCAPTCHA V2 Enterprise and reCAPTCHA V3 Enterprise using cURL, Python, JavaScript (Node.js), and Go are provided below.

3. Retrieve the ID of the created CAPTCHA.
4. Request the solution result from https://api.solvecaptcha.com/res.php

   Example URL request:

   https://api.solvecaptcha.com/res.php?key=1abc234de56fab7c89012d34e56fa7b8&action=get&json=1&id=2122988149

5. Use the received token on the website. The method of applying the token depends on the specific web resource and the requests it performs. There is no universal algorithm for this.
6. If, after using the token, it becomes clear whether it worked or not, you can notify us. If the CAPTCHA was not successfully solved, send a reportbad. If the CAPTCHA was successfully solved, send a reportgood.

List of GET/POST Request Parameters for https://api.solvecaptcha.com/in.php

List of GET/POST Parameters for https://api.solvecaptcha.com/res.php

Code examples for sending reCAPTCHA V2 Enterprise:

curl --location 'https://api.solvecaptcha.com/in.php' \
    --form 'key="1abc234de56fab7c89012d34e56fa7b8"' \
    --form 'method="userrecaptcha"' \
    --form 'googlekey="6LfD3PIbAAAAAJs_eEHvoOl75_83eXSqpPSRFJ_u"' \
    --form 'pageurl="https://mysite.com/page/containing/recaptcha-v2-enterprise"' \
    --form 'enterprise="1"' \
    --form 'userAgent="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"' \
    --form 'cookies="KEY1:Value1;KEY2:Value2;"' \
    --form 'data-s="data-s_example_value"' \
    --form 'invisible="0"' \
    --form 'json="1"'

import requests
  
  url = "https://api.solvecaptcha.com/in.php"
  
  payload = {'key': '1abc234de56fab7c89012d34e56fa7b8',
  'method': 'userrecaptcha',
  'googlekey': '6LfD3PIbAAAAAJs_eEHvoOl75_83eXSqpPSRFJ_u',
  'pageurl': 'https://mysite.com/page/containing/recaptcha-v2-enterprise',
  'enterprise': '1',
  'userAgent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
  'cookies': 'KEY1:Value1;KEY2:Value2;',
  'data-s': 'data-s_example_value',
  'invisible': '0',
  'json': '1'}
  files=[
  
  ]
  headers = {}
  
  response = requests.request("POST", url, headers=headers, data=payload, files=files)
  
  print(response.text)

var request = require('request');
  var options = {
    'method': 'POST',
    'url': 'https://api.solvecaptcha.com/in.php',
    'headers': {
    },
    formData: {
      'key': '1abc234de56fab7c89012d34e56fa7b8',
      'method': 'userrecaptcha',
      'googlekey': '6LfD3PIbAAAAAJs_eEHvoOl75_83eXSqpPSRFJ_u',
      'pageurl': 'https://mysite.com/page/containing/recaptcha-v2-enterprise',
      'enterprise': '1',
      'userAgent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
      'cookies': 'KEY1:Value1;KEY2:Value2;',
      'data-s': 'data-s_example_value',
      'invisible': '0',
      'json': '1'
    }
  };
  request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
  });

package main
  
  import (
    "fmt"
    "bytes"
    "mime/multipart"
    "net/http"
    "io"
  )
  
  func main() {
  
    url := "https://api.solvecaptcha.com/in.php"
    method := "POST"
  
    payload := &bytes.Buffer{}
    writer := multipart.NewWriter(payload)
    _ = writer.WriteField("key", "1abc234de56fab7c89012d34e56fa7b8")
    _ = writer.WriteField("method", "userrecaptcha")
    _ = writer.WriteField("googlekey", "6LfD3PIbAAAAAJs_eEHvoOl75_83eXSqpPSRFJ_u")
    _ = writer.WriteField("pageurl", "https://mysite.com/page/containing/recaptcha-v2-enterprise")
    _ = writer.WriteField("enterprise", "1")
    _ = writer.WriteField("userAgent", "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36")
    _ = writer.WriteField("cookies", "KEY1:Value1;KEY2:Value2;")
    _ = writer.WriteField("data-s", "data-s_example_value")
    _ = writer.WriteField("invisible", "0")
    _ = writer.WriteField("json", "1")
    err := writer.Close()
    if err != nil {
      fmt.Println(err)
      return
    }
  
  
    client := &http.Client {
    }
    req, err := http.NewRequest(method, url, payload)
  
    if err != nil {
      fmt.Println(err)
      return
    }
    req.Header.Set("Content-Type", writer.FormDataContentType())
    res, err := client.Do(req)
    if err != nil {
      fmt.Println(err)
      return
    }
    defer res.Body.Close()
  
    body, err := io.ReadAll(res.Body)
    if err != nil {
      fmt.Println(err)
      return
    }
    fmt.Println(string(body))
  }

Code examples for sending reCAPTCHA V3 Enterprise:

curl --location 'https://api.solvecaptcha.com/in.php' \
    --form 'key="1abc234de56fab7c89012d34e56fa7b8"' \
    --form 'method="userrecaptcha"' \
    --form 'googlekey="6Lel38UnAAAAAMRwKj9qLH2Ws4Tf2uTDQCyfgR6b"' \
    --form 'pageurl="https://mysite.com/page/containing/recaptcha-v3-enterprise"' \
    --form 'version="v3"' \
    --form 'enterprise="1"' \
    --form 'action="demo_action"' \
    --form 'min_score="0.5"' \
    --form 'domain="www.recaptcha.net"' \
    --form 'userAgent="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"' \
    --form 'cookies="KEY1:Value1;KEY2:Value2;"' \
    --form 'data-s="data-s_example_value"' \
    --form 'json="1"'

import requests

  url = "https://api.solvecaptcha.com/in.php"
  
  payload = {'key': '1abc234de56fab7c89012d34e56fa7b8',
  'method': 'userrecaptcha',
  'googlekey': '6Lel38UnAAAAAMRwKj9qLH2Ws4Tf2uTDQCyfgR6b',
  'pageurl': 'https://mysite.com/page/containing/recaptcha-v3-enterprise',
  'version': 'v3',
  'enterprise': '1',
  'action': 'demo_action',
  'min_score': '0.5',
  'domain': 'www.recaptcha.net',
  'userAgent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
  'cookies': 'KEY1:Value1;KEY2:Value2;',
  'data-s': 'data-s_example_value',
  'json': '1'}
  files=[
  
  ]
  headers = {}
  
  response = requests.request("POST", url, headers=headers, data=payload, files=files)
  
  print(response.text)

var request = require('request');
  var options = {
    'method': 'POST',
    'url': 'https://api.solvecaptcha.com/in.php',
    'headers': {
    },
    formData: {
      'key': '1abc234de56fab7c89012d34e56fa7b8',
      'method': 'userrecaptcha',
      'googlekey': '6Lel38UnAAAAAMRwKj9qLH2Ws4Tf2uTDQCyfgR6b',
      'pageurl': 'https://mysite.com/page/containing/recaptcha-v3-enterprise',
      'version': 'v3',
      'enterprise': '1',
      'action': 'demo_action',
      'min_score': '0.5',
      'domain': 'www.recaptcha.net',
      'userAgent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
      'cookies': 'KEY1:Value1;KEY2:Value2;',
      'data-s': 'data-s_example_value',
      'json': '1'
    }
  };
  request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
  });

package main

  import (
    "fmt"
    "bytes"
    "mime/multipart"
    "net/http"
    "io"
  )
  
  func main() {
  
    url := "https://api.solvecaptcha.com/in.php"
    method := "POST"
  
    payload := &bytes.Buffer{}
    writer := multipart.NewWriter(payload)
    _ = writer.WriteField("key", "1abc234de56fab7c89012d34e56fa7b8")
    _ = writer.WriteField("method", "userrecaptcha")
    _ = writer.WriteField("googlekey", "6Lel38UnAAAAAMRwKj9qLH2Ws4Tf2uTDQCyfgR6b")
    _ = writer.WriteField("pageurl", "https://mysite.com/page/containing/recaptcha-v3-enterprise")
    _ = writer.WriteField("version", "v3")
    _ = writer.WriteField("enterprise", "1")
    _ = writer.WriteField("action", "demo_action")
    _ = writer.WriteField("min_score", "0.5")
    _ = writer.WriteField("domain", "www.recaptcha.net")
    _ = writer.WriteField("userAgent", "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36")
    _ = writer.WriteField("cookies", "KEY1:Value1;KEY2:Value2;")
    _ = writer.WriteField("data-s", "data-s_example_value")
    _ = writer.WriteField("json", "1")
    err := writer.Close()
    if err != nil {
      fmt.Println(err)
      return
    }
  
  
    client := &http.Client {
    }
    req, err := http.NewRequest(method, url, payload)
  
    if err != nil {
      fmt.Println(err)
      return
    }
    req.Header.Set("Content-Type", writer.FormDataContentType())
    res, err := client.Do(req)
    if err != nil {
      fmt.Println(err)
      return
    }
    defer res.Body.Close()
  
    body, err := io.ReadAll(res.Body)
    if err != nil {
      fmt.Println(err)
      return
    }
    fmt.Println(string(body))
  }

Cloudflare Turnstile

Cloudflare Turnstile is a CAPTCHA system developed by Cloudflare designed to protect web forms and pages from automated submissions or malicious activity.

Turnstile is used in two scenarios:

1. As a standalone CAPTCHA widget embedded on a webpage to safeguard forms against automated submissions. In this setup, the sitekey is retrieved and sent to the API alongside the full page URL. The resulting token is then added to the cf-turnstile-response and g-recaptcha-response fields before form submission. Optionally, a callback can be defined in the turnstile.render method.
2. On Cloudflare-proxied websites where the Turnstile Challenge page appears. In this case, specific parameters (cData, chlPageData, and action) must be extracted, along with the User-Agent value provided by the API.

Standalone Turnstile captcha

Request example:

https://mysite.com/in.php?method=turnstile&key=YOUR_API_KEY&sitekey=0x4AAAAAAAVrOwQWPlm3Bnr5&pageurl=https%3A%2F%2Fmysite.com%2Fregister&json=1

Code examples for submitting Cloudflare Turnstile using cURL, Python, JavaScript, and Go are described below.

Response example:

{
  "status": 1,
  "request": "74327409378"
}

The returned ID can be used to retrieve the CAPTCHA solution by sending a request to the res.php endpoint of the API.

Turnstile captcha on Cloudflare Challenge pages

To bypass the Turnstile CAPTCHA on Cloudflare Challenge pages, you must include the following additional parameters in your request:

• action: The action parameter value extracted from the page.
• data: The cData value passed to the turnstile.render method or defined in the data-cdata attribute.
• pagedata: The chlPageData value passed to the turnstile.render method.

How to extract the required parameters

To extract the required parameters, you can redefine the turnstile.render method to capture the parameters passed to it during execution. This involves injecting JavaScript code into the page before the Turnstile widget is initialized. Below is an example of how to achieve this:

const i = setInterval(() => {
  if (window.turnstile) {
    clearInterval(i);
    window.turnstile.render = (a, b) => {
      let p = {
        method: "turnstile",
        key: "YOUR_API_KEY",
        sitekey: b.sitekey,
        pageurl: window.location.href,
        data: b.cData,
        pagedata: b.chlPageData,
        action: b.action,
        userAgent: navigator.userAgent,
        json: 1
      };
      console.log(JSON.stringify(p));
      window.tsCallback = b.callback;
      return 'foo';
    };
  }
}, 50);

Request example:

https://api.solvecaptcha.com/in.php?key=YOUR_API_KEY&method=turnstile&sitekey=0x0AAAAAAADnPIDROzbs0Aaj&data=7fab0000b0e0ff00&pagedata=3gAFo2...0ME1UVT0=&pageurl=https://mysite.com/&action=managed&json=1

Response example:

{
"status": 1,
"request": "74327409378"
}

Use the returned ID to request the result from res.php endpoint of our API:

https://api.solvecaptcha.com/res.php?key=1abc234de56fab7c89012d34e56fa7b8&action=get&id=74327409378&json=1

Result example:

{
"status": 1,
"request": "0.4uMMZZdSfsVM8...610cd090",
"useragent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/115.0.0.0 Safari/537.36"
}

List of GET/POST request parameters for https://api.solvecaptcha.com/in.php

* - parameters required to bypass Turnstile on Cloudflare Challenge pages

List of GET request parameters for https://api.solvecaptcha.com/res.php

Request URL example:

https://api.solvecaptcha.com/res.php?key=1abc234de56fab7c89012d34e56fa7b8&action=get&id=2122988149

Code examples for send Cloudflare Turnstile:

curl --location 'https://api.solvecaptcha.com/in.php' \
--form 'key="YOUR_API_KEY"' \
--form 'method="turnstile"' \
--form 'sitekey="0x1AAAAAAAAkg0s2VIOD34y5"' \
--form 'pageurl="https://mysite.com/register"' \
--form 'json="1"'

import requests

url = "https://api.solvecaptcha.com/in.php"

payload = {'key': 'YOUR_API_KEY',
'method': 'turnstile',
'sitekey': '0x1AAAAAAAAkg0s2VIOD34y5',
'pageurl': 'https://mysite.com/register',
'json': '1'}
files=[

]
headers = {}

response = requests.request("POST", url, headers=headers, data=payload, files=files)

print(response.text)

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://api.solvecaptcha.com/in.php',
  'headers': {
  },
  formData: {
    'key': 'YOUR_API_KEY',
    'method': 'turnstile',
    'sitekey': '0x4AAAAAAAPMtoL-SSuvUpPf',
    'pageurl': 'https://mysite.com/page/containing/cloudflare-turnstile',
    'json': '1'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

package main

  import (
    "fmt"
    "bytes"
    "mime/multipart"
    "net/http"
    "io"
  )
  
  func main() {
  
    url := "https://api.solvecaptcha.com/in.php"
    method := "POST"
  
    payload := &bytes.Buffer{}
    writer := multipart.NewWriter(payload)
    _ = writer.WriteField("key", "YOUR_API_KEY")
    _ = writer.WriteField("method", "turnstile")
    _ = writer.WriteField("sitekey", "0x1AAAAAAAAkg0s2VIOD34y5")
    _ = writer.WriteField("pageurl", "https://mysite.com/register")
    _ = writer.WriteField("json", "1")
    err := writer.Close()
    if err != nil {
      fmt.Println(err)
      return
    }
  
  
    client := &http.Client {
    }
    req, err := http.NewRequest(method, url, payload)
  
    if err != nil {
      fmt.Println(err)
      return
    }
    req.Header.Set("Content-Type", writer.FormDataContentType())
    res, err := client.Do(req)
    if err != nil {
      fmt.Println(err)
      return
    }
    defer res.Body.Close()
  
    body, err := io.ReadAll(res.Body)
    if err != nil {
      fmt.Println(err)
      return
    }
    fmt.Println(string(body))
  }

Amazon captcha

Amazon captcha, also known as AWS WAF captcha, is a component of the system provided by Amazon AWS.

To bypass the captcha, you need to collect the following parameters from the challenged page:

• sitekey - value of the key parameter in the page source
• iv - value of the iv parameter in the page source
• context - value of the context parameter in the page source
• challenge_script - the URL of the challenge.js script
• captcha_script- the URL of the captcha.js script
• pageurl - the full URL of the page where the CAPTCHA challenge was presented

Request Example POST https://api.solvecaptcha.com/in.php

{
  "key": "YOUR_API_KEY",
  "method": "amazon_waf",
  "sitekey": "XXXXX",
  "pageurl": "https://non-existent-example.execute-api.us-east-1.amazonaws.com/latest",
  "context": "XXXXX",
  "challenge_script": "https://XXXXX.token.awswaf.com/XXXXX.js",
  "captcha_script": "https://XXXXX.captcha.awswaf.com/XXXXX/captcha.js",
  "iv": "XXXXX",
  "json": 1
}

If the request is successful, the response will look like this:

{
  "status": 1,
  "request": "XXXXX"
}

If the request fails, an error code will be returned instead.

Retrieving the Result

Wait 15–20 seconds, then send a request to GET https://api.solvecaptcha.com/res.php

Solved CAPTCHA Response

If the CAPTCHA has been solved:

{
  "status": 1,
  "request": {
    "captcha_voucher": "XXXXX",
    "existing_token": "XXXXX"
  }
}

CAPTCHA Not Ready

If the CAPTCHA is still being solved:

{
  "status": 0,
  "request": "CAPCHA_NOT_READY"
}

Try again in 5 seconds.

Error Handling

If something goes wrong, the server will return an error code. Refer to the error list for details.

Parameter Reference

List of POST request parameters for https://api.solvecaptcha.com/in.php

List of GET request parameters for https://api.solvecaptcha.com/res.php

GET example:

https://api.solvecaptcha.com/res.php?key=XXXXX&action=get&id=XXXXX

Cutcaptcha

Token-based method for automated solving of Cutcaptcha.

The token received must be set as the value attribute of the input#cap_token element and/or passed to the callback function.

Method specification

Request example POST https://api.solvecaptcha.com/in.php

{
  "key": "YOUR_API_KEY",
  "method": "cutcaptcha",
  "misery_key": "c73e1d4a92b6f80c5d1a7e6b34f2c918ab05d7e4",
  "api_key": "K7d42QPx",
  "pageurl": "https://example.cc/foo/bar.html",
  "json": 1
}

Request will return the id of your captcha. Use it to get the result.

Getting the result POST https://api.solvecaptcha.com/res.php

{
  "key": "YOUR_API_KEY",
  "action": "get",
  "id": 2122988149,
  "json": 1
}

Result example

{
  "status": 1,
  "request": "Qx7L9kRtJm2aBBbWvHdP4FNy6TSuC8eZ"
}

Using the token

Use the returned token as a value for input with id = cap_token, then submit it's parent form, for example:

document.querySelector('input#cap_token').value = 'Qx7L9kRtJm2aBBbWvHdP4FNy6TSuC8eZ';
document.querySelector('form').submit();

If there's a callback function defined, you can call it passing the token as argument:

capResponseCallback('Qx7L9kRtJm2aBBbWvHdP4FNy6TSuC8eZ');

https://solvecaptcha.com/res.php?key=1abc234de56fab7c89012d34e56fa7b8&action=get&id=2122988149

{
  "key": "YOUR_API_KEY",
  "method": "mt_captcha",
  "sitekey": "MTPublic-KzqLY1cKH",
  "pageurl": "https://solvecaptcha.com/demo/mtcaptcha",
  "json": 1
}

{
  "key": "YOUR_API_KEY",
  "action": "get",
  "id": 1984783152,
  "json": 1
}

{
  "status": 1,
  "request": "v1(b3d91ac7,9ab4d2e..7f1c9a6b3d4e,Q7k2Lp9)"
}

{
  "key": "YOUR_API_KEY",
  "method": "friendly_captcha",
  "sitekey": "7KXMD4TQ9PL8RW",
  "pageurl": "https://example.com",
  "version": "v1",
  "module_script": "https://cdn.example.com/static/js/friendly-challenge/@0.9.1/widget.module.min.js",
  "nomodule_script": "https://cdn.example.com/static/js/friendly-challenge/@0.9.1/widget.js",
  "json": 1
}

{
  "key": "YOUR_API_KEY",
  "method": "friendly_captcha",
  "sitekey": "7KXMD4TQ9PL8RW",
  "pageurl": "https://example.com",
  "version": "v2",
  "module_script": "https://cdn.example.com/v2/widget.module.min.js",
  "nomodule_script": "https://cdn.example.com/v2/widget.js",
  "json": 1
}

{
  "key": "YOUR_API_KEY",
  "action": "get",
  "id": "2112373961",
  "json": 1
}

{
  "status": 1,
  "request": "c3e9a7d5f1b2486fae7c93d2ab41e8f0.Q7K2L...BBBBBB.BhEF",
}

document.querySelector('input.frc-captcha-solution').value = 'c3e9a7d5f1b2486fae7c93d2ab41e8f0.Q7K2L...BBBBBB.BhEF';
document.querySelector('form').submit();

doneCallback('c3e9a7d5f1b2486fae7c93d2ab41e8f0.Q7K2L...BBBBBB.BhEF');

https://api.solvecaptcha.com/res.php?key=1abc234de56fab7c89012d34e56fa7b8&action=get&id=2122988149

curl --location 'https://api.solvecaptcha.com/in.php' \
--form 'key="YOUR_API_KEY"' \
--form 'method="geetest"' \
--form 'gt="f1ab2cdefa3456789012345b6c78d90e"' \
--form 'challenge="12345678abc90123d45678ef90123a456b"' \
--form 'api_server="api-na.geetest.com"' \
--form 'pageurl="https://www.site.com/page/"'

import requests

url = "https://api.solvecaptcha.com/in.php"

payload = {'key': 'YOUR_API_KEY',
'method': 'geetest',
'gt': 'f1ab2cdefa3456789012345b6c78d90e',
'challenge': '12345678abc90123d45678ef90123a456b',
'api_server': 'api-na.geetest.com',
'pageurl': 'https://www.site.com/page/'}
files=[

]
headers = {}

response = requests.request("POST", url, headers=headers, data=payload, files=files)

print(response.text)

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://api.solvecaptcha.com/in.php',
  'headers': {
  },
  formData: {
    'key': 'YOUR_API_KEY',
    'method': 'geetest',
    'gt': 'f1ab2cdefa3456789012345b6c78d90e',
    'challenge': '12345678abc90123d45678ef90123a456b',
    'api_server': 'api-na.geetest.com',
    'pageurl': 'https://www.site.com/page/'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

package main

import (
  "fmt"
  "bytes"
  "mime/multipart"
  "net/http"
  "io"
)

func main() {

  url := "https://api.solvecaptcha.com/in.php"
  method := "POST"

  payload := &bytes.Buffer{}
  writer := multipart.NewWriter(payload)
  _ = writer.WriteField("key", "YOUR_API_KEY")
  _ = writer.WriteField("method", "geetest")
  _ = writer.WriteField("gt", "f1ab2cdefa3456789012345b6c78d90e")
  _ = writer.WriteField("challenge", "12345678abc90123d45678ef90123a456b")
  _ = writer.WriteField("api_server", "api-na.geetest.com")
  _ = writer.WriteField("pageurl", "https://www.site.com/page/")
  err := writer.Close()
  if err != nil {
    fmt.Println(err)
    return
  }


  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Set("Content-Type", writer.FormDataContentType())
  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := io.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

https://api.solvecaptcha.com/res.php?key=1abc234de56fab7c89012d34e56fa7b8&action=get&id=2122988149

curl --location 'https://api.solvecaptcha.com/in.php' \
--form 'key="YOUR_API_KEY"' \
--form 'method="geetest_v4"' \
--form 'captcha_id="e392e1d7fd421dc63325744d5a2b9c73"' \
--form 'pageurl="https://www.site.com/page/"' \
--form 'json="1"'

import requests

url = "https://api.solvecaptcha.com/in.php"

payload = {'key': 'YOUR_API_KEY',
'method': 'geetest_v4',
'captcha_id': 'e392e1d7fd421dc63325744d5a2b9c73',
'pageurl': 'https://www.site.com/page/',
'json': '1'}
files=[

]
headers = {}

response = requests.request("POST", url, headers=headers, data=payload, files=files)

print(response.text)

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://api.solvecaptcha.com/in.php',
  'headers': {
  },
  formData: {
    'key': 'YOUR_API_KEY',
    'method': 'geetest_v4',
    'captcha_id': 'e392e1d7fd421dc63325744d5a2b9c73',
    'pageurl': 'https://www.site.com/page/',
    'json': '1'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

package main

import (
  "fmt"
  "bytes"
  "mime/multipart"
  "net/http"
  "io"
)

func main() {

  url := "https://api.solvecaptcha.com/in.php"
  method := "POST"

  payload := &bytes.Buffer{}
  writer := multipart.NewWriter(payload)
  _ = writer.WriteField("key", "YOUR_API_KEY")
  _ = writer.WriteField("method", "geetest_v4")
  _ = writer.WriteField("captcha_id", "e392e1d7fd421dc63325744d5a2b9c73")
  _ = writer.WriteField("pageurl", "https://www.site.com/page/")
  _ = writer.WriteField("json", "1")
  err := writer.Close()
  if err != nil {
    fmt.Println(err)
    return
  }


  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Set("Content-Type", writer.FormDataContentType())
  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := io.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

FunCaptcha

Now we provide a method to solve FunCaptcha with a token.

The method is pretty simple:

• You need to locate public key of FunCaptcha. There are two ways to find it: you can locate funcaptcha's div element and check the value of data-pkey parameter parameter or you can find the input element with name fc-token and then extract the key indicated after pk from the value of this element.

• Submit a HTTP GET or POST request to our API URL: https://api.solvecaptcha.com/in.php with method set to funcaptcha and provide the value found on previous step as value for publickey and full page URL as value for pageurl. Sending proxies is not obligatory ar the moment but it's recommended.
  You can find the full list of parameters in the table below.

  Request URL example:

  https://api.solvecaptcha.com/in.php?key=1abc234de56fab7c89012d34e56fa7b8&method=funcaptcha&publickey=12AB34CD-56F7-AB8C-9D01-2EF3456789A0&pageurl=http://mysite.com/page/with/funcaptcha/

• If everything is fine server will return the ID of your captcha as plain text, like: OK|2122988149 or as JSON {"status":1,"request":"2122988149"} if json parameter was used.
  Otherwise server will return an error code.

• Make a 10-20 seconds timeout then submit a HTTP GET request to our API URL: https://api.solvecaptcha.com/res.php to get the result.
  The full list of parameters is in the table below.

  If captha is already solved server will respond in plain text or JSON and return the answer token that looks like:

  3084f4a302b176cd7.96368058|r=ap-southeast-1|guitextcolor=%23FDD531|metabgclr=%23FFFFFF|metaiconclr=%23202122|meta=3|lang=en|pk=12AB34CD-56F7-AB8C-9D01-2EF3456789A0|cdn_url=https://cdn.funcaptcha.com/fc|surl=https://funcaptcha.com

  If captcha is not solved yet server will return CAPCHA_NOT_READY result. Retry your request after 5 seconds.
  

  If something gone wrong server will return an error code.

• Locate the element with id fc-token and put the token into value of this element.

  Please note: if you use nojs=1 parameter API will return just first part of token string like this: 3084f4a302b176cd7.96368058|r=ap-southeast-1 and you got to build the full string using the original value of fc-token

• Do the rest what you need to do on the website: submit a form or click on a button or something else.

List of GET/POST request parameters for https://api.solvecaptcha.com/in.php

List of GET request parameters for https://api.solvecaptcha.com/res.php

Request URL example:

https://api.solvecaptcha.com/res.php?key=1abc234de56fab7c89012d34e56fa7b8&action=get&id=2122988149

Code examples for send FunCaptcha:

curl --location 'https://api.solvecaptcha.com/in.php' \
--form 'key="YOUR_API_KEY"' \
--form 'method="funcaptcha"' \
--form 'publickey="A8C45173-7FGA-5DFF-7130-P27HFM194E10"' \
--form 'surl="https://blizzard-api.arkoselabs.com"' \
--form 'data="{\"blob\":\"59GUybcGVCPYwwTt...kc9GEVDZNVj5Q==\"}"' \
--form 'pageurl="https://www.site.com/page/"' \
--form 'userAgent="Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.0.0.0 Safari/537.36"' \
--form 'json="1"'
                  

import requests

url = "https://api.solvecaptcha.com/in.php"

payload = {'key': 'YOUR_API_KEY',
'method': 'funcaptcha',
'publickey': 'A8C45173-7FGA-5DFF-7130-P27HFM194E10',
'surl': 'https://blizzard-api.arkoselabs.com',
'data': '{"blob":"59GUybcGVCPYwwTt...kc9GEVDZNVj5Q=="}',
'pageurl': 'https://www.site.com/page/',
'userAgent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.0.0.0 Safari/537.36',
'json': '1'}

headers = {}

response = requests.request("POST", url, headers=headers, data=payload, files=files)

print(response.text)
                  

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://api.solvecaptcha.com/in.php',
  'headers': {
  },
  formData: {
    'key': 'YOUR_API_KEY',
    'method': 'funcaptcha',
    'publickey': 'A8C45173-7FGA-5DFF-7130-P27HFM194E10',
    'surl': 'https://blizzard-api.arkoselabs.com',
    'data': '{"blob":"59GUybcGVCPYwwTt...kc9GEVDZNVj5Q=="}',
    'pageurl': 'https://www.site.com/page/',
    'userAgent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.0.0.0 Safari/537.36',
    'json': '1'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});
                  

package main

import (
  "fmt"
  "bytes"
  "mime/multipart"
  "net/http"
  "io"
)

func main() {

  url := "https://api.solvecaptcha.com/in.php"
  method := "POST"

  payload := &bytes.Buffer{}
  writer := multipart.NewWriter(payload)
  _ = writer.WriteField("key", "YOUR_API_KEY")
  _ = writer.WriteField("method", "funcaptcha")
  _ = writer.WriteField("publickey", "A8C45173-7FGA-5DFF-7130-P27HFM194E10")
  _ = writer.WriteField("surl", "https://blizzard-api.arkoselabs.com")
  _ = writer.WriteField("data", "{\"blob\":\"59GUybcGVCPYwwTt...kc9GEVDZNVj5Q==\"}")
  _ = writer.WriteField("pageurl", "https://www.site.com/page/")
  _ = writer.WriteField("userAgent", "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.0.0.0 Safari/537.36")
  _ = writer.WriteField("json", "1")
  err := writer.Close()
  if err != nil {
    fmt.Println(err)
    return
  }


  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Set("Content-Type", writer.FormDataContentType())
  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := io.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}
                  

Grid method

Solving reCAPTCHA V2 with that old method is less accurate and more compex. So we recommend to use the new method. But the old method is cheaper and we still support it.

We can solve recaptchas with different grids like 3x3, 2x4, 4x4.

Also you can solve reCAPTCHA V2 with ClickCaptcha method if it's more suitable for you.

And of course we support reCAPTCHA V2 challenges when you have to select around an object or few objects. Read more here.

To solve the reCAPTCHA V2 you have to:

• Click on initial reCAPTCHA's checkbox. You will get a set of images and an instruction that tells you what to click. Actually it's one image with the grid on it.

• Optionally: determine the grid and define it in your request with recaptchacols and recaptcharows parameters.
  If not defined we'll check the size of the image. If it's 300x300px we put 3x3 grid on it. If the size is different we put 4x4 grid.

• Submit a HTTP POST request to our API URL: https://api.solvecaptcha.com/in.php providing recaptcha parameter set to 1.

  Server accepts images in multipart or base64 format. You have to send only the image set without the grid and blue box.

  Also you can provide instructions as an image using imginstructions parameter. For more info please check the full list of parameters in the table below.

• Server will return captcha ID or an error code if something gone wrong.

• Make a 5 seconds timeout and submit a HTTP GET request to our API URL: https://api.solvecaptcha.com/res.php to get the result.

  If captha is already solved server will return the answer with numbers of grid cells that you need to click like: OK|click:3/8/9/.

  Grid cells are numbered starting from number 1 from left to right from top to bottom. If the grid contain more than 9 cells, letters a-g are used for cells 10-16.

  If captcha is not solved yet server will return CAPCHA_NOT_READY result. Retry your request after 5 seconds.

  If something gone wrong server will return an error code.

• You simulate clicks on cells from the answer.

Canvas method

In case when reCAPTCHA challenge is to select around object you can pass canvas parameter set to 1.

Server will return the result in the following format: canvas:x,y,x,y,x,y;x,y,x,y,x,y;

Where each pair of x and y are coordinates of points you need to click to select an area around object. If there are more than one area, coordininates of areas will be separated by semicolon.

For example:
canvas:5,5,3,91,93,90,90,7,8,6; - one area
canvas:5,5,3,91,93,90,90,7,8,6;208,211,208,287,294,294,293,209,207,210; - two areas
Point 0,0 is top left corner of the image.

You need to click on these points one by one to pass the challenge.

Multipart sample form for reCAPTCHA V2 old method

<form method="post" action="https://api.solvecaptcha.com/in.php" enctype="multipart/form-data">
<input type="hidden" name="method" value="post">
<input type="hidden" name="recaptcha" value="1"><br>
<input type="hidden" name="canvas" value="0"><br>
Your key:
<input type="text" name="key" value="YOUR_APIKEY">
reCAPTCHA file:
<input type="file" name="file">
Image with instruction:
<input type="file" name="imginstructions">
<input type="submit" value="Upload and get the ID">
</form>

YOUR_APIKEY is Your API key.

Base64 sample form for reCAPTCHA V2 old method

<form method="post" action="https://api.solvecaptcha.com/in.php">
<input type="hidden" name="method" value="base64">
<input type="hidden" name="recaptcha" value="1"><br>
<input type="hidden" name="canvas" value="0"><br>
Your key:
<input type="text" name="key" value="YOUR_APIKEY">
reCAPTCHA file body in base64 format:
<textarea name="body">BASE64_RECAPTCHA_FILE</textarea>
Image with instruction body in base64 format:
<textarea name="imginstructions">BASE64_INSTRUCTION_FILE</textarea>
<input type="submit" value="Upload and get the ID">
</form>

YOUR_APIKEY is your API key.

BASE64_RECAPTCHA_FILE is base64-encoded image body of reCAPTCHA V2.

BASE64_INSTRUCTION_FILE is base64-encoded image body of image with instruction.

List of POST request parameters for https://api.solvecaptcha.com/in.php

Please note: you have to send the reCAPTCHA image itself, not its screenshot. And you dont have to combine that image with anything you like, just send it as is.
Max size for reCAPTCHA image is 100 kB.
Max size for imginstructions is 25 kB.

List of GET request parameters for https://api.solvecaptcha.com/res.php

Request URL example:

https://api.solvecaptcha.com/res.php?key=1abc234de56fab7c89012d34e56fa7b8&action=get&id=2122988149

ClickCaptcha

This method allows you to solve any captcha that requires clicking on images, like Shapchat's Ghost Captcha, reCAPTCHA V2, ASIRRA, etc.

To solve any ClickCaptcha you have to:

• Get an image and an instruction that tells you what to click.

• Submit a HTTP POST request to our API URL: https://api.solvecaptcha.com/in.php providing coordinatescaptcha parameter set to 1.
  Server accepts images in multipart or base64 format.

  file File Yes* Captcha image file.
  * - required if you submit image as a file (method=post) body String Yes* Base64-encoded captcha image
  * - required if you submit image as Base64-encoded string (method=base64)

  You can provide an instruction as text using textinstructions parameter, but it's not obligatory if the instruction is already indicated on the image.

  The full list of parameters is in the table below.

• Server will return captcha ID or an error code if something gone wrong.

• Make a 5 seconds timeout and submit a HTTP GET request to our API URL: https://api.solvecaptcha.com/res.php to get the result.

  If captha is already solved server will return the answer with coordinates of points where you have to click, for example: OK|coordinate:x=39,y=59;x=252,y=72. Where the point with x=0,y=0 is the upper left corner of the image.

  If captcha is not solved yet server will return CAPCHA_NOT_READY result. Retry your request after 5 seconds.

  If something gone wrong server will return an error code.

• You simulate clicks on coordinates from the answer.

Multipart sample form for ClickCaptcha

<form method="post" action="https://api.solvecaptcha.com/in.php" enctype="multipart/form-data">
<input type="hidden" name="method" value="post">
<input type="hidden" name="coordinatescaptcha" value="1">
Your key:
<input type="text" name="key" value="YOUR_APIKEY">
ClickCaptcha file:
<input type="file" name="file">
Instruction:
<input type="text" name="textinstructions" value="Click on ghosts">
<input type="submit" value="Upload and get the ID">
</form>

YOUR_APIKEY is Your API key.

Base64 sample form for ClickCaptcha

<form method="post" action="https://api.solvecaptcha.com/in.php">
<input type="hidden" name="method" value="base64">
<input type="hidden" name="coordinatescaptcha" value="1">
Your key:
<input type="text" name="key" value="YOUR_APIKEY">
ClickCaptcha file body in base64 format:
<textarea name="body">BASE64_CLICKCAPTCHA_FILE</textarea>
Instruction
<input type="text" name="textinstructions" value="Click on ghosts">
<input type="submit" value="Upload and get the ID">
</form>

YOUR_APIKEY is your API key.

BASE64_CLICKCAPTCHA_FILE is base64-encoded image body of ClickCaptcha.

List of POST request parameters for https://api.solvecaptcha.com/in.php

List of GET request parameters for https://api.solvecaptcha.com/res.php

Request URL example:

https://api.solvecaptcha.com/res.php?key=1abc234de56fab7c89012d34e56fa7b8&action=get&id=2122988149

RotateCaptcha

RotateCaptcha is a type of captcha where you have to rotate images to solve it. The most popular is FunCaptcha.

To solve RotateCaptcha you have to:

• Get an image or several images that should be rotated.

• Optionally: determine the angle for one rotation step and provide it as a value for angle parameter.
  If not defined we'll use the default value for FunCaptcha: 40 degrees.

  The full list of parameters is in the table below.

• Submit images to our server with HTTP POST request to our API URL: https://api.solvecaptcha.com/in.php setting method parameter to rotatecaptcha. Server accepts images only in multipart format.

  Server will return captcha ID or an error code if something gone wrong.

• Make a 5 seconds timeout and submit a HTTP GET request to our API URL: https://api.solvecaptcha.com/res.php to get the result.

  If captha is already solved server will return the answer with angles for each image like: OK|40|200|-120.
  Positive values mean that images should be rotated clockwise.
  Negative values mean that images should be rotated counter-clockwise.

  If captcha is not solved yet server will return CAPCHA_NOT_READY result. Retry your request after 5 seconds.
  If something gone wrong server will return an error code.

• Rotate images to given angles to solve your RotateCaptcha.

Sample form for RotateCaptcha

<form method="post" action="https://api.solvecaptcha.com/in.php" enctype="multipart/form-data">
KEY:<br>
<input  name="key" value="YOUR_APIKEY"><br>
Type<br>
<input  name="method" value="rotatecaptcha"><br>
Angle<br>
<input  name="angle" value="40"><br>
Files:<br>
<input type="file" name="file_1"><br>
<input type="submit" value="Upload and get the ID">
</form>

YOUR_APIKEY is your API key.

List of POST request parameters for https://api.solvecaptcha.com/in.php

List of GET request parameters for https://api.solvecaptcha.com/res.php

Request URL example:

https://api.solvecaptcha.com/res.php?key=1abc234de56fab7c89012d34e56fa7b8&action=get&id=2122988149

key=YOUR_API_KEY
method=captchafox
sitekey=XXXXX
pageurl=https://mysite.com/page/with/captcha-fox
proxy=login:[email protected]:8080
proxytype=http
useragent=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/115.0.0.0 Safari/537.36
json=1

https://api.solvecaptcha.com/in.php?key=YOUR_API_KEY&method=captchafox&sitekey=XXXXX&pageurl=https://mysite.com/page/with/captcha-fox&proxy=login:[email protected]:8080&proxytype=http&useragent=Mozilla/5.0%20(Windows%20NT%2010.0;%20Win64;%20x64)%20AppleWebKit/537.36%20(KHTML,%20like%20Gecko)%20Chrome/115.0.0.0%20Safari/537.36&json=1

key=YOUR_API_KEY
action=get
id=XXXXX
json=1

https://api.solvecaptcha.com/res.php?key=YOUR_API_KEY&action=get&id=XXXXX&json=1

{
  "status": 1,
  "request": "XXXXX"
}

{
  "key": "YOUR_API_KEY",
  "method": "temuimage",
  "body": "data:image/png;base64,iVBORw0KG...",
  "part1": "data:image/png;base64,iVBORw0KG...",
  "part2": "data:image/png;base64,iVBORw0KG...",
  "part3": "data:image/png;base64,iVBORw0KG...",
  "json": 1
}

{
  "key": "YOUR_API_KEY",
  "action": "get",
  "id": 2122988149,
  "json": 1
}

{
  "cost": "0.0012",
  "createTime": 1754563182,
  "endTime": 1754563190,
  "errorId": 0,
  "ip": "46.53.232.76",
  "solution": {
      "coordinates": [
          {
              "x": 155,
              "y": 358
          },
          {
              "x": 152,
              "y": 153
          },
          {
              "x": 251,
              "y": 333
          }
      ]
  },
  "solveCount": 1,
  "status": "ready"
}

Language support

Our API allows you to specify the captcha language using the lang parameter. Each worker in our system declares the languages they can read. When you submit a captcha with the lang parameter, the task is routed to workers who support that language. This makes it possible to solve captchas in non-Latin and non-Cyrillic scripts, such as Chinese or Vietnamese.

The list of supported languages is provided in the table below.

Error Handling

It's very important to use proper error handling in your code to avoid suspension of your account and service interruption.

Normally if something is wrong with your request server will return an error.
Below you can find tables with lists of errors with description:

• errors returned by https://api.solvecaptcha.com/in.php

• errors returned by https://api.solvecaptcha.com/res.php

Errors can be returned as plain text or as JSON if you provided json=1 parameter.

In very rare cases server can return an HTML page with error text like 500 or 502 - please keep it in mind and handle such cases correctly.
If you received anything that doesn't looks like the answer or error code - make a 5 seconds timeout and then retry your request.

List of in.php errors

List of res.php errors

Request limits

Please remember and understand that each your request to our API generates multuple requests to our databases. That's why we ask to set proper timeouts for your requests and use proper error handling for cases when server returns an error (error message, http error or html page with error).

For example:

• If server returns ERROR_NO_SLOT_AVAILABLE make a 5 seconds timeout before sending next request.
• If server returns ERROR_ZERO_BALANCE set the timeout to 60 seconds.
• After uploading a captcha wait a least 5 seconds (10-20 for reCAPTCHA) and only then try to get the answer.
• If captcha is not solved yet - retry to get the answer after 5 seconds.

If your timeouts are configured incorrectly your account or IP address will be temporary blocked and server will return an error. See the list of error codes in the table below.

Error codes list for request limitations

Using proxies

Get the best residential proxies at 2Captcha Proxy 🔥 Just follow the link to get 50% off — available for all SolveCaptcha users!

Proxies can be used to solve reCAPTCHA V2 and FunCaptcha from the same IP address as you load the page.
Using proxies is not obligatory at the moment but in future algorithms of reCAPTCHA and FunCaptcha can be changed and it will be required.
And even now some websites check IP address used for solving reCAPTCHA V2. So we recommend you to be ready for these changes.

If you send us the proxy, we check it's availability trying to open the website through you proxy, and if we can't do that we will not use your proxy.
If we're able to use your proxy - we'll load the reCAPTCHA through it for solving.

We don't have our own proxy servers that we can offer to you so you have to use 3rd-party services or setup your own proxy.

We support the following proxy types: SOCKS4, SOCKS5, HTTP, HTTPS with authentication by IP address or login and password.

If your proxy uses IP authentication you have to add our IP addresses to the list of allowed IPs of the proxy:
138.201.188.166

Then provide your proxy IP address and port as a value for proxy parameter.
And the type of your proxy as a value for proxytype parameter.

If your proxy uses login/password authentication you have to include your credentials in proxy parameter.

POST parameters for proxies

Cookies Parameter

Our API provides enhanced cookie support for reCAPTCHA V2 and reCAPTCHA V2 Enterprise.

You can submit your own cookies by specifying them in the json_cookies parameter using the format shown below. These cookies will be applied in our worker's browser.

Once the captcha is successfully solved, we will return all cookies set for the google.com domain and the target website specified in the pageurl parameter.

To retrieve the cookies, include the json=1 parameter in your request to res.php.

Cookie format:

{
    "json_cookies": [
        {
            "name": "my-cookie-name-1",
            "value": "my-cookie-val-1",
            "domain": "example.com",
            "hostOnly": true,
            "path": "/",
            "secure": true,
            "httpOnly": false,
            "session": false,
            "expirationDate": 1665434653,
            "sameSite": "strict"
        },
        {
            "name": "my-cookie-name-2",
            "value": "my-cookie-val-2",
            "domain": ".google.com",
            "hostOnly": false,
            "path": "/",
            "secure": true,
            "httpOnly": false,
            "session": false,
            "expirationDate": 1668015805.8028,
            "sameSite": "no_restriction"
        }
    ]
}

Mandatory Properties for Submitted Cookies

When submitting cookies, the following mandatory parameters must be specified:

All submitted cookies must include the parameters listed above to be correctly applied in the worker's browser.

Reporting answers

Submitting reports on answers is an optional operation, but it helps improve the accuracy of the service and the quality of solutions. If you find that the captcha answer was incorrect, you can file a complaint about the incorrect answer. Our moderators will review your captcha and the worker's response to determine whether the answer was correct or not. Your complaint will help us block workers who frequently make mistakes.

It is recommended to always submit reports on both incorrect and correct answers to enhance the accuracy of the service.

reportbad

Use reportbad if the captcha answer was rejected by the website. Submitting reportbad requests helps the system identify workers with a high error rate and block them, thereby improving service quality.

reportgood

Use reportgood if the captcha solution was successfully accepted by the website. This helps improve the accuracy of request processing in the future.

Request examples:

ReportBAD:

https://api.solvecaptcha.com/res.php?action=reportbad&id=2122988149&key=1abc234de56fab7c89012d34e56fa7b8
                

ReportGOOD:

https://api.solvecaptcha.com/res.php?action=reportgood&id=2122988149&key=1abc234de56fab7c89012d34e56fa7b8
                

Important: Don't try to send reportbad for correctly solved captchas. If you do so, your account will be banned.

List of GET request parameters for https://api.solvecaptcha.com/res.php

Server will return OK_REPORT_RECORDED response to your request. Or an error code if something gone wrong.

If you're getting too many incorrectly solved captchas you may provide additional parameters with your captcha to help wokers to solve it correctly

Additional methods

You can also get some additional information with our API, like balance, current rate, etc.
Please check available parameters in the table below.

List of GET request parameters for https://api.solvecaptcha.com/res.php