Skip to main content

CaptchaAI API Quickstart Guide

Welcome to CaptchaAI! This quickstart guide will help you get started with CaptchaAI's captcha solving API, allowing you to make your first API call and begin exploring the possibilities of captcha bypassing.

Solving any CAPTCHA with CaptchaAI involves just a few simple steps, regardless of the CAPTCHA type.​

  1. Send your image or captcha to our server.
  2. Get the ID of your task.
  3. Start a cycle that checks if your task is completed.
  4. Get the result.

Prerequisites: Sign Up and Get Your API Key​

  1. Visit the CaptchaAI.com.
  2. Create your account and log in.
  3. Navigate to your Dashboard to retrieve your API key.
  4. Contact our support to get a free trial or purchase a plan.

Your API key is required to authenticate all API requests. Make sure you have threads before continuing to the next step.

Step 1: Send your image or captcha to our server​

Let's start by making a simple request to the CaptchaAI API. Use the following curl command to send a reCAPTCHA v3 solve request to in.php endpoint:

curl -X POST https://ocr.captchaai.com/in.php \
-F "key=YOUR_API_KEY_HERE" \
-F "method=userrecaptcha" \
-F "version=v3" \
-F "googlekey=6LdKlZEpAAAAAAOQjzC2v_d36tWxCl6dWsozdSy9" \
-F "pageurl=https://recaptcha-demo.appspot.com/recaptcha-v3-request-scores.php" \
-F "json=1"

Step 2: Get the TaskID​

You will receive a respose like this:

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

This response confirms that our OCR server has been successfully received your solve request and started the solving proccess. This part 0123456789 is the TaskID. Save it as it will be used later to get the captcha answer.

Step 3: Start a cycle that checks if your task is completed.​

Next, We will check the result endpoint every 5 seconds unitl we get the token.

Polling rate may vary for each captcha type.

To check the result endpoint res.php for the token, use this curl command:

curl -X POST https://ocr.captchaai.com/res.php \
-F "key=YOUR_API_KEY_HERE" \
-F "action=get" \
-F "id=YOUR_TASKID_HERE" \
-F "json=1"

Basic Error handling​

Handling CAPCHA_NOT_READY​

If you received CAPCHA_NOT_READY, this means that our servers is still proccessing the task. In this case, simply continue polling every 5 seconds.

Request Example

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

Handling ERROR_CAPTCHA_UNSOLVABLE​

In some rare cases, you may receive ERROR_CAPTCHA_UNSOLVABLE, this means that our servers faild to solve the task. In this case review you request format and parameter values and try again

Request Example

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

Step 4: Get the result​

You will receive a response like this:

{
    "status": 1,
    "request": "0cAFcWeA5vgLQUZ9NXgDsnDN7NiNl-8i7jNh4W4-bnKv_YlsbSA9GYxMRiONkRdAreUyIYybnwy8DxxxxIufjLwO3iQ13Y0ytpklfwND9SLx1qu1fQPVfkYJoOYg2nxiAf2ogrtsYK_ZytmVD8wGuoUzjEIFxT7eUI1IAji-dmNS2dJQxLv8XhL2GW9S0s-eOAvTq69j1Nu0DMnZU_UMs5qRq1fvaCwj6zHgUvH5H642xUuZMTgDCWEkiCpL_xLIfj06xPFw6NwcI_B7zrhGBax8xNVn5X7rQhB9hVERozRVbXnbNatHrAzKPdTPQH1zodkZbbA7ihHOGKLD5Uq1ODxSZLHJqQPYV1l51_7Fe................."
}

This is the reCAPTCHA v3 token, you can use it to bypass the reCAPTCHA v3 protection on the target site.

For more info on how to use the token you can visit reCAPTCHA v3 Solving Guide

Congratulations!​

You’ve completed your first CAPTCHA defeating mission using the CaptchaAI API! Explore more advanced features in our documentation.