#CAPTCHA

#Captcha is a quite new type of captcha that is really similar to reCAPTCHA and looks like this:

Captcha

First open developer's console in your browser and find the value of data-sitekey parameter in the source code of the page.

1. CREATE TASK

Request

GET/POST https://24captcha.online/in.php

name type required description
key text yes
Client API key, can be found here
sitekey text yes Value of data-sitekey parameter you found on page
pageurl text no
Address of a target web page with captcha. If you didn't send pageurl worker will generate fake url.
json number Default: 0 no 0 - server will send the response as plain text, 1 - tells the server to send the response as JSON
proxy text no Format: login:[email protected]:3128
proxytype text no Type of your proxy: HTTPS, HTTP
rqdata text no In most cases you see it as rqdata inside network requests.
invisible bool Default: false no Use true for invisible version of captcha.
enterprise bool Default: false no Use true for enterprise or discord captcha.

Request POST Example 1

server will send the response as plain text

POST /in.php HTTP/1.1
Host: 24captcha.online
Content-Type: application/json

{
      "key": "YOUR_API_KEY",
      "sitekey": "00000000-0000-0000-0000-000000000000",
      "pageurl": "https://example.com/",
      "json": 0
}

Response TEXT

OK|00000000-0000-0000-0000-000000000000
ERROR_KEY

Request POST Example 2

server will send the response as JSON

POST /in.php HTTP/1.1
Host: 24captcha.online
Content-Type: application/json

{
      "key": "YOUR_API_KEY",
      "sitekey": "00000000-0000-0000-0000-000000000000",
      "pageurl": "https://example.com/",
      "json": 1
}

Response JSON

{
      "request": "00000000-0000-0000-0000-000000000000",
      "status": 1
}
{
      "error_text": "ERROR_TEXT",
      "request": "ERROR_KEY",
      "status": 0
}

2. GET TASK RESULT

Request

GET/POST https://24captcha.online/res.php

name type required description
key text yes
Client API key, can be found here
action text yes get - get the answer for your captcha
id text yes ID of captcha returned by in.php.
json number Default: 0 no 0 - server will send the response as plain text, 1 - tells the server to send the response as JSON

Request POST Example 1

server will send the response as plain text

POST /res.php HTTP/1.1
Host: 24captcha.online
Content-Type: application/json

{
      "key": "YOUR_API_KEY",
      "id": "00000000-0000-0000-0000-000000000000",
      "action": "get",
      "json": 0
}

Response TEXT

OK|3AHJ_VuvYIBNBW5yyv0zRYJ75VkOK.....
CAPCHA_NOT_READY
ERROR_CAPTCHA_UNSOLVABLE

Request POST Example 2

server will send the response as JSON

POST /res.php HTTP/1.1
Host: 24captcha.online
Content-Type: application/json

{
      "key": "YOUR_API_KEY",
      "id": "00000000-0000-0000-0000-000000000000",
      "action": "get",
      "json": 1
}

Response JSON

{
      "request": "3AHJ_VuvYIBNBW5yyv0zRYJ75VkOK.....",
      "status": 1
}
{
      "request": "CAPCHA_NOT_READY"
      "status": 0
}
{
      "request": "ERROR_CAPTCHA_UNSOLVABLE",
      "status": 0
}
  • status = 1 : Solved successfully, read result in request
  • status = 0 and request = CAPCHA_NOT_READY : The task is not ready yet, make 5 seconds timeout and repeat your request.
  • status = 0 : error identifier. Error code and short description transferred in errorCode and errorDescription properties

List of in.php errors

Error code Description Action
ERROR_WRONG_USER_KEY You've provided key parameter value in incorrect format, it should contain 32 symbols.
Stop sending requests. Check your API key.
ERROR_KEY_DOES_NOT_EXIST The key you've provided does not exist.
Stop sending requests. Check your API key.
ERROR_ZERO_BALANCE Account has zero or negative balance. Stop sending requests and make deposit.
ERROR_PAGEURL
Not valid pageurl.
Stop sending requests and change your code to provide valid pageurl parameter. More info.
IP_BANNED Your IP address is banned due to many frequent attempts to access the server using wrong authorization keys. Ban will be automatically lifted after 5 minutes.
ERROR_PROXY_FORMAT
You use incorrect proxy format in your request to in.php
Use proper format as described.
ERROR_BAD_PARAMETERS
The error code is returned if some required parameters are missing in your request or the values have incorrect format.
Check that your request contains all the required parameters and the values are in proper format.
ERROR_BAD_PROXY You can get this error code when sending a captcha via proxy server which is marked as BAD by our API. Use a different proxy server in your requests.
ERROR_SITEKEY You can get this error code when sending captcha. That means that sitekey value provided in your request is incorrect: it's blank or malformed.
Check your code that gets the sitekey and makes requests to our API.

List of res.php errors

Error code Description Action
CAPCHA_NOT_READY Your captcha is not solved yet.
Make 5 seconds timeout and repeat your request.
ERROR_CAPTCHA_UNSOLVABLE Captcha could not be solved, or we didn't get an answer within 90 seconds. We will not charge you for that request. You can retry to send your captcha.
ERROR_WRONG_USER_KEY You've provided key parameter value in incorrect format, it should contain 32 symbols.
Stop sending requests. Check your API key.
ERROR_KEY_DOES_NOT_EXIST Account authorization key not found in the system. Make sure you copied it correctly without spaces and tabulation signs.
Stop sending requests. Check your API key.
ERROR_WRONG_CAPTCHA_ID Captcha key not found in the system or was automatically removed after 15 minutes. Check the ID of captcha or your code that gets the ID.
ERROR_EMPTY_ACTION
Action parameter is missing or no value is provided for action parameter.
Check your request parameters and add the necessary value.