How It Works Why Use an API for CAPTCHA Solving Automated CAPTCHA Solving via API Error Handling: Main Types and Troubleshooting Instructions

Automatic CAPTCHA Recognition via CapMonster Cloud API

CAPTCHA recognition via CapMonster Cloud API is the automated process of recognizing and solving words or symbols using programming interfaces. With CapMonster Cloud, you can automate CAPTCHA bypassing and simplify and speed up your workflow.

How It Works

The API performs CAPTCHA solving using the following process:

1. Request Submission

The client sends a request to the API server, providing CAPTCHA data (image, site keys, URL).

2. Processing

The API server processes the request, recognizes the CAPTCHA, and starts solving it.

3. Receiving the Solution

The API server solves the CAPTCHA, allowing the client to proceed with verification.

Why Use an API for CAPTCHA Solving

APIs (Application Programming Interfaces) automate actions on websites.

Completing registration forms

Extracting and copying data

Sending various types of information to a server

Automated CAPTCHA Solving via API

CapMonster Cloud API uses standard HTTP requests with data sent in JSON format.

API Addresses

createTask
Creates a CAPTCHA solving task.
JSON POST
```
https://api.capmonster.cloud/createTask
```
getTaskResult
Checks task status and retrieves results.
JSON POST
```
https://api.capmonster.cloud/getTaskResult
```
getBalance
Retrieves the current account balance.
JSON POST
```
https://api.capmonster.cloud/getBalance
```
getUserAgent
Provides the latest browser and OS data.
JSON POST
```
https://capmonster.cloud/api/useragent/actual
```

Captcha Solving Algorithm

Obtaining the Key

First, obtain your unique API key in the CapMonster Cloud personal dashboard..

Sending a Request to Create a Task

Send an HTTP POST request to the address:

https://api.capmonster.cloud/createTask

Include your API key and task details in the request.

This is how your request should look:

{
  "clientKey":"API_KEY",
  "task": {
    "type":"RecaptchaV2TaskProxyless",
    "websiteURL":"https://example.com/",
    "websiteKey":"6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd"
  }
}

The server will return the CAPTCHA identifier (taskId) or an error code if something goes wrong.

Obtaining the Response

After creating the task, send a request to obtain the response to the address:

https://api.capmonster.cloud/getTaskResult

Include your API key and the task identifier (taskId).

This is how your request should look:

{
  "clientKey":"API_KEY",
  "taskId":12345678
}

The server will solve the captcha or provide information that the task is still in progress.

Example response:

{
  "errorId":0,
  "status":"ready",
  "solution": {
    "gRecaptchaResponse":"response_token" 
  }
}

Error Handling: Main Types and Troubleshooting Instructions

Main errors you may encounter:

INVALID KEY

API error code: ERROR_KEY_DOES_NOT_EXIST

This notification indicates that the API key entered is incorrect or does not exist. Check if you entered it correctly and try again.

NO FUNDS

API error code: ERROR_ZERO_BALANCE

This notification highlights that you do not have enough funds to complete the task (i.e., the balance is zero). Top up your account to continue solving.

BIG IMAGE SIZE

API error code: ERROR_TOO_BIG_CAPTCHA_FILESIZE

This notification indicates that the CAPTCHA size is exceeded.

ZERO IMAGE SIZE

API error code: ERROR_ZERO_CAPTCHA_FILESIZE

This notification indicates that the CAPTCHA size you are uploading is less than 100 bytes.

CAPTCHA ID IS NOT FOUND

API error code: ERROR_NO_SUCH_CAPCHA_ID, WRONG_CAPTCHA_ID

The CAPTCHA was not found in the system (its ID could not be located). CAPTCHA status should be checked within the first 5 minutes after submission. Make sure to check within this timeframe.

CAPTCHA UNSOLVABLE

API error code: ERROR_CAPTCHA_UNSOLVABLE

This type of CAPTCHA is not supported by the service, or the image does not contain a readable answer, meaning it is noise. It might be damaged or incorrectly rendered.

CAPTCHA IS NOT READY

API error code: CAPTCHA_NOT_READY

The CAPTCHA has not yet been solved. Just wait a minute or two.

REQUEST IS NOT ALLOWED FROM YOUR IP

API error code: ERROR_IP_NOT_ALLOWED

This notification indicates that the request from this IP address has been rejected. Open your personal account settings and add your IP to the allowlist.

IP BANNED

API error code: ERROR_IP_BANNED

You have exceeded the request limit with an incorrect API key. Check the key and try to create the task again.

INCORRECT METHOD

API error code: ERROR_NO_SUCH_METHOD

The CAPTCHA type (value of the "type" parameter) is incorrect. Check the correctness of the method used.

THE TOKEN IS EXPIRED

API error code: ERROR_TOKEN_EXPIRED

When recognizing the CAPTCHA, its provider noticed that the additional token had expired. Create a new task, get a new token, and retry the request.

NO FREE SERVERS

API error code: ERROR_NO_SLOT_AVAILABLE

All servers are busy. Try again later.

INVALID RECAPTCHA SITEKEY

API error code: ERROR_RECAPTCHA_INVALID_SITEKEY

An incorrect reCAPTCHA key was provided. Check the correctness of the sitekey.

RECAPTCHA TIMEOUT

API error code: ERROR_RECAPTCHA_TIMEOUT

This notification indicates that the execution time for solving the reCAPTCHA has exceeded the allowable time set on the server, and the task cannot be completed within the specified time frame. Try submitting the request again later.

YOUR IP IS BLOCKED

API error code: ERROR_IP_BLOCKED

Access from the specified IP address is prohibited due to a large number of errors. Check the frequency of your requests. Change your IP. Consider the limits when creating tasks.

FAILED TO CONNECT PROXY

API error code: ERROR_PROXY_CONNECT_REFUSED

The service cannot establish a connection through the specified proxy server. Check the correctness of proxy settings (IP, port, login, password) and its availability. Use another one.

THE PROXY IP IS BANNED

API error code: ERROR_PROXY_BANNED

The proxy has been banned on the target CAPTCHA service by its IP. Use another one.

ERROR_TASK_ABSENT

API error code: ERROR_TASK_ABSENT

The task object was not found, or an invalid JSON was sent. Make sure everything is correct. Check if the task execution time has expired.

Always refer to the documentation to use only the latest API parameters and methods.

Important! Encountered a different error and don’t know how to resolve it? Refer to the following guide to help you address the issue: https://docs.capmonster.cloud/docs/api/api-errors/.