Index

Download the api client based example codes:

New Funcaptcha by Image API support

What is a "FunCAPTCHA by Image" challenge?

These are challenges that usually involve users aligning and clicking on specific images. FunCAPTCHA by Image enables users to solve these challenges by providing them with information on which image to select or how many clicks are required.

For your convenience, we implemented support for Funcaptcha by Image API. If your software works with it, and supports minimal configuration, you should be able to decode Funcaptchas by Images using Death By Captcha in no time.

  • Funcaptcha by Image API: When given a FunCAPTCHA challenge image and the type of question, the API returns the precise number (starting from 0) corresponding to the image that solves the FunCAPTCHA challenge.

Pricing

For the time being, price is $2.89/1K Funcaptcha by Images correctly solved. You will not be billed for Funcaptcha by Image reported as incorrectly solved. Note that this pricing applies to new Funcaptcha by Image challenges only, so only customers using this specific API will be charged said rate.

Funcaptcha by Image API FAQ:

What`s the Funcaptcha by Image API URL?

To use the Funcaptcha by Image API you will have to send a HTTP POST Request to http://api.dbcapi.me/api/captcha

What are the POST parameters for the Funcaptcha by Image API?

  • username: Your DBC account username
  • password: Your DBC account password
  • type=22: Type 22 specifies this is a Funcaptcha by Image API
  • funcaptchaimage_params=json(payload): the data to access the funcaptcha by image challenge
  • json payload structure:
    • image: an encoded base64 string representing the image. Please note that the the size should be lower than 120 KB.
    • question: this parameter value is extracted from either the "game_variant" or "instruction_string" field within the response of the "/gfct" API. For example: "rotated", "3d_rollball_objects", "coordinatesmatch".
    • module (optional): the name of the module to which the question belongs.
    • sitekey (optional): the funcaptcha site key of the website with the funcaptcha.

      Example:

      • 029EF0D3-41DE-03E1-6971-466539B47725

      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 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.

    • pageurl (optional): the url of the page with the Funcaptcha challenges. This url has to include the path in which the Funcaptcha is loaded. Example: if the Funcaptcha you want to solve is in http://test.com/path1, pageurl has to be http://test.com/path1 and not http://test.com.

    The following table shows the supported modules and questions:

    Module (module parameter) Question (question parameter)
    dice

    dice_5_revised

    dice_6_revised

    dice_7_revised

    dice_8_revised

    dice_9_revised

    dice_slow_14_revised

    dice14

    dice_pair dice_pair
    frankenhead frankenhead
    shadows shadows
    shadow_top_icons shadow-icons-top
    shadow_puppets shadow-puppets
    shadow_icons shadow-icons
    square_icon

    square_icon_pair

    square_icon_three

    rope ropes
    maze maze
    maze_3d maze2
    counting counting
    flockCompass flockCompass
    mismatched_jigsaw mismatched-jigsaw
    reflection reflection
    animal_looking_standing animalLookStanding
    card card
    cube_icon mismatched-cube
    galaxies galaxies
    rotated rotated
    gametype gameType1
    hand_number_puzzle_4 hand_number_puzzle
    hand_number_puzzle_3 hand_number_puzzle_2
    penguins penguins
    fc_icon

    apple

    camera

    car

    flower

    pig

    dart

    dart

    dart01

    dart02

    dart03

    dart04

    dart05

    dart06

    dart_matchkey darts_matchkey
    3d_rollball_objects 3d_rollball_objects
    3d_rollball_animals_multi

    3d_rollball_animals

    3d_rollball_animals_alt

    3d_rollball_animals_multi

    coordinatesmatch coordinatesmatch
    dice_match dicematch
    hopscotch

    hopscotch_highsec

    hopscotch_v2

    icon_connect icon_connect
    numbermatch numericalmatch
    train_coorinatesmatch train_coordinates
    train_simple trains_simple
    rockstack rockstack
    rockgroup rockgroup
    topdowngame

    topdowngame

    topdownscene

    knots_crosses_circle knotsCrossesCircle
    knots_crosses_knot knotsCrossesKnot
    stairs_walking stairs_walking
    cardistance cardistance
    orbit_match_game orbit_match_game
    ringtoss ringtoss
    veggiemadness_alt veggiemadness_alt
    BrokenJigsawbrokenjigsaw_swap BrokenJigsawbrokenjigsaw_swap
    conveyor conveyor
    diceico diceico

    Full example of funcaptchaimage_params:

    
    {
        'image': 'UklGRiQAAABXQVZFZm10IBAAAAABAAEAIlYAAESsAAACABAAZGF0YQQAAAAA....',
        'question': 'maze',
        'module': 'maze',
        'sitekey': '029EF0D3-41DE-03E1-6971-466539B47725',
        'pageurl': 'https://testsite.com/xxx-test'
    }
                

What`s the response from the Funcaptcha by Image API?

The Funcaptcha API response has the following structure. It will be a number like the following indicating the location of the solution starting from (0):


4
      

The example response means that the solution is the fourth image starting from zero (0) among the images in the image challenge sent.

Using Funcaptcha by Image API with api clients:


    /**
     * Death by Captcha PHP API funcaptcha by image usage example
     *
     * @package DBCAPI
     * @subpackage PHP
     */

    /**
     * DBC API clients
     */
    require_once '../deathbycaptcha.php';

    $username = "username";  // DBC account username
    $password = "password";  // DBC account password
    $token_from_panel = "your-token-from-panel";  // DBC account authtoken

    // Use DeathByCaptcha_SocketClient() class if you want to use SOCKET API.
    $client = new DeathByCaptcha_HttpClient($username, $password);
    $client->is_verbose = true;

    // To use token the first parameter must be authtoken.
    // $client = new DeathByCaptcha_HttpClient("authtoken", $token_from_panel);

    echo "Your balance is {$client->balance} US cents\n";

    // Read the image file and get the base64 encoded string
    try {
        $fileData = file_get_contents("images/funcaptcha.jpeg");
        $base64Data = base64_encode($fileData);
    } catch (Exception $e) {
        echo 'An error occurred while reading the file: ',  $e->getMessage(), "\n";
    }

    // funcaptcha data
    $data = array(
        'image' => $base64Data,
        'question' => 'coordinatesmatch'
    );
    //Create a json string
    $json = json_encode($data);

    //Put the type and the json payload
    $extra = [
        'type' => 22,
        'funcaptchaimage_params' => $json,
    ];

    // Put null the first parameter and add the extra payload
    if ($captcha = $client->decode(null, $extra)) {
        echo "CAPTCHA {$captcha['captcha']} uploaded\n";

        sleep(DeathByCaptcha_Client::DEFAULT_TIMEOUT);

        // Poll for CAPTCHA indexes:
        if ($text = $client->get_text($captcha['captcha'])) {
            echo "CAPTCHA {$captcha['captcha']} solved: {$text}\n";

            // Report an incorrectly solved CAPTCHA.
            // Make sure the CAPTCHA was in fact incorrectly solved!
            //$client->report($captcha['captcha']);
        }
    }

        

    # funcaptcha by image
    import deathbycaptcha
    import json

    # Put your DBC account username and password here.
    username = "username"
    password = "password"

    # you can use authtoken instead of user/password combination
    # activate and get the authtoken from DBC users panel
    authtoken = "authtoken"

    # to use socket client
    # client = deathbycaptcha.SocketClient(username, password)

    # to use authtoken
    # client = deathbycaptcha.SocketClient(username, password, authtoken)

    client = deathbycaptcha.HttpClient(username, password)

    # Read the image file and get the base64 string
    try:
        with open('images/funcaptcha.jpeg', 'rb') as file:
            img_data = file.read()
            base_string = base64.b64encode(img_data).decode()
    except Exception as e:
        print("An error occurred while converting the file to base64: " + str(e))

    Captcha_dict = {
        'image': base_string,
        'question': 'coordinatesmatch'
    }

    # Create a json string
    json_Captcha = json.dumps(Captcha_dict)

    try:
        balance = client.get_balance()
        print(balance)

        # Put your CAPTCHA type and Json payload here:
        captcha = client.decode(type=22, funcaptchaimage_params=json_Captcha)
        if captcha:
            # The CAPTCHA was solved; captcha["captcha"] item holds its
            # numeric ID, and captcha["text"] its text token solution.
            print("CAPTCHA %s solved: %s" % (captcha["captcha"], captcha["text"]))

            if '':  # check if the CAPTCHA was incorrectly solved
                client.report(captcha["captcha"])

    except deathbycaptcha.AccessDeniedException:
        # Access to DBC API denied, check your credentials and/or balance
        print("error: Access to DBC API denied, check your credentials and/or balance")

        

    import com.DeathByCaptcha.AccessDeniedException;
    import com.DeathByCaptcha.Client;
    import com.DeathByCaptcha.HttpClient;
    import com.DeathByCaptcha.SocketClient;
    import com.DeathByCaptcha.Captcha;
    import org.json.JSONObject;

    import java.io.IOException;

    class ExampleFuncaptchaImage {
        public static void main(String[] args)
                throws Exception {

            // Put your DBC username & password or authtoken here:
            String username = "your_username_here";
            String password = "your_password_here";
            String authtoken = "your_authtoken_here";

            // The path to the image file
            String filePath = "images/funcaptcha.jpeg";
            String encodedString = null;

            // Read the image file and encode the file to base64
            try {
                byte[] fileContent = Files.readAllBytes(Paths.get(filePath));
                encodedString = Base64.getEncoder().encodeToString(fileContent);
            } catch (IOException e) {
                e.printStackTrace();
            }

            String img = encodedString;

            /* Death By Captcha Socket Client
               Client client = (Client) (new SocketClient(username, password));
               Death By Captcha http Client */
            Client client = (Client) (new HttpClient(username, password));
            client.isVerbose = true;

            /* Using authtoken
               Client client = (Client) new HttpClient(authtoken); */

            try {
                try {
                    System.out.println("Your balance is " + client.getBalance() + " US cents");
                } catch (IOException e) {
                    System.out.println("Failed fetching balance: " + e.toString());
                    return;
                }

                Captcha captcha = null;
                try {
                    /* Upload a CAPTCHA and poll for its status with 120 seconds timeout.
                       Put you CAPTCHA img file base64 encoded, the question and solving
                       timeout (in seconds) if 0 the default value take place.
                       please note we are specifying type=22 */
                    // funcaptcha data
                    String question = "coordinatesmatch";
                    /* Upload a funcaptcha by image and poll for its status with 120 seconds timeout.
                       Put your image and question */
                    JSONObject json_params = new JSONObject();
                    json_params.put("question", question);
                    json_params.put("image", img);
                    captcha = client.decode(22, json_params);
                } catch (IOException e) {
                    System.out.println("Failed uploading CAPTCHA");
                    return;
                }
                if (null != captcha) {
                    System.out.println("CAPTCHA " + captcha.id + " solved: " + captcha.text);

                    /* Report incorrectly solved CAPTCHA if necessary.
                       Make sure you've checked if the CAPTCHA was in fact incorrectly
                       solved, or else you might get banned as abuser. */
                    /*try {
                        if (client.report(captcha)) {
                            System.out.println("Reported as incorrectly solved");
                        } else {
                            System.out.println("Failed reporting incorrectly solved CAPTCHA");
                        }
                    } catch (IOException e) {
                        System.out.println(
                            "Failed reporting incorrectly solved CAPTCHA: " + e.toString()
                        );
                    }*/
                } else {
                    System.out.println("Failed solving CAPTCHA");
                }
            } catch (com.DeathByCaptcha.Exception e) {
                System.out.println(e);
            }


        }
    }

        

    // funcaptcha by image

    using System;
    using System.Collections;
    using DeathByCaptcha;

    namespace DBC_Examples.examples
    {
        public class FuncaptchaImageExample
        {
            public void Main()
            {
                // Put your DeathByCaptcha account username and password here.
                string username = "your username";
                string password = "your password";
                // string token_from_panel = "your-token-from-panel";

                /* Death By Captcha Socket Client
                   Client client = (Client) new SocketClient(username, password);
                   Death By Captcha http Client */
                Client client = (Client) new HttpClient(username, password);

                /* To use token authentication the first parameter must be "authtoken".
                Client client = (Client) new HttpClient("authtoken", token_from_panel); */

                // Read the image file and convert it to base64 string
                string base64String = null;
                try
                {
                    byte[] fileBytes = File.ReadAllBytes("images/funcaptcha.jpeg");
                    base64String = Convert.ToBase64String(fileBytes);
                }
                catch (Exception ex)
                {
                    Console.WriteLine("An error occurred while converting the file to base64: " + ex.Message);
                }

                // Put your funcaptcha data here
                string image = base64String;
                string question = "coordinatesmatch";

                string funcaptchaImageParams = "{\"image\": \"" + image + "\"," +
                                          "\"question\": \"" + question + "\"}";

                try
                {
                    double balance = client.GetBalance();

                    /* Upload a CAPTCHA and poll for its status. Put the Token CAPTCHA
                       Json payload, CAPTCHA type and desired solving timeout (in seconds)
                       here. If solved, you'll receive a DeathByCaptcha.Captcha object. */
                    Captcha captcha = client.Decode(Client.DefaultTimeout,
                        new Hashtable()
                        {
                            {"type", 22},
                            {"funcaptchaimage_params", funcaptchaImageParams}
                        });

                    if (null != captcha)
                    {
                        /* The CAPTCHA was solved; captcha.Id property holds
                        its numeric ID, and captcha.Text holds its text. */
                        Console.WriteLine("CAPTCHA {0} solved: {1}", captcha.Id,
                            captcha.Text);

    //                  if ( /* check if the CAPTCHA was incorrectly solved */)
    //                  {
    //                      client.Report(captcha);
    //                  }
                    }
                }
                catch (AccessDeniedException e)
                {
                    /* Access to DBC API denied, check your credentials and/or balance */
                    Console.WriteLine("### exception : " + e.ToString());
                }
            }
        }
    }

        

    Imports DeathByCaptcha

    Public Class FuncaptchaImage
        Sub Main(args As String())

            ' Put your DBC username & password or authtoken here:
            Dim username = "username"
            Dim password = "password"
            Dim token_from_panel = "your-token-from-panel"

            ' DBC Socket API client
            ' Dim client As New SocketClient(username, password)
            ' DBC HTTP API client
            Dim client As New HttpClient(username, password)

            ' To use token auth the first parameter must be "authtoken"
            ' Dim client As New HttpClient("authtoken", token_from_panel)

            ' Read the image file and convert it to base64 string
            Dim base64String As String = Nothing
            Try
                Dim fileBytes As Byte() = File.ReadAllBytes("images/funcaptcha.jpeg")
                base64String = Convert.ToBase64String(fileBytes)
            Catch ex As System.Exception
                Console.WriteLine("An error occurred while converting the file to base64: " & ex.Message)
            End Try

            ' funcaptcha data
            Dim question as String = "coordinatesmatch"

            ' Create a JSON with the extra data
            Dim funcaptchaImageParams as String = "{""image"": """ + base64String + """," +
                                   """question"": """ + question + """}"

            Console.WriteLine(String.Format("Your balance is {0,2:f} US cents",
                                            client.Balance))

            ' Create the payload with the type and the data
            Dim extraData As New Hashtable()
            extraData.Add("type", 22)
            extraData.Add("funcaptchaimage_params", funcaptchaImageParams)

            ' Upload a CAPTCHA and poll for its status. Put the Funcaptcha Image
            ' parameters, CAPTCHA type and desired solving timeout (in seconds)
            ' here. If solved, you'll receive a DeathByCaptcha.Captcha object.
            Dim captcha As Captcha = client.Decode(DeathByCaptcha.Client.DefaultTimeout, extraData)
            If captcha IsNot Nothing Then
                Console.WriteLine(String.Format("CAPTCHA {0:d} solved: {1}", captcha.Id,
                                                captcha.Text))

                ' Report an incorrectly solved CAPTCHA.
                ' Make sure the CAPTCHA was in fact incorrectly solved, do not
                ' just report it at random, or you might be banned as abuser.
                ' If client.Report(captcha) Then
                '    Console.WriteLine("Reported as incorrectly solved")
                ' Else
                '    Console.WriteLine("Failed reporting as incorrectly solved")
                ' End If
            End If
        End Sub
    End Class
        

    /*
    * Death by Captcha Node.js API funcaptcha by image usage example
    */

    const dbc = require('../deathbycaptcha');

    const username = 'username';     // DBC account username
    const password = 'password';     // DBC account password
    const token_from_panel = 'your-token-from-panel';   // DBC account authtoken

    // Read the image file and convert it to base64 string
    let base64String = null;
    try {
        const fileData = fs.readFileSync('images/funcaptcha.jpeg');
        base64String = fileData.toString('base64');
      } catch (error) {
        console.error('An error occurred while reading the file:', error);
      }

    // funcaptcha data
    const funcaptchaimage_params = JSON.stringify({
        'image': base64String,
        'question': 'coordinatesmatch'
    });

    // Death By Captcha Socket Client
    // const client = new dbc.SocketClient(username, password);
    // Death By Captcha http Client
    const client = new dbc.HttpClient(username, password);

    // To use token authentication the first parameter must be "authtoken"
    // const client = new dbc.HttpClient("authtoken", token_from_panel);

    // Get user balance
    client.get_balance((balance) => {
        console.log(balance);
    });

    // Solve captcha with type 22 & funcaptchaimage_params extra arguments
    client.decode({extra: {type: 22,  funcaptchaimage_params: funcaptchaimage_params}}, (captcha) => {

        if (captcha) {
            console.log('Captcha ' + captcha['captcha'] + ' solved: ' + captcha['text']);

            /*
            * Report an incorrectly solved CAPTCHA.
            * Make sure the CAPTCHA was in fact incorrectly solved!
            * client.report(captcha['captcha'], (result) => {
            *   console.log('Report status: ' + result);
            * });
            */

        }

    });
        

Status: OK

Servers are fully operational with faster than average response time.
  • Average solving time
  • 1 seconds - Normal CAPTCHAs (1 min. ago)
  • 30 seconds - reCAPTCHA V2, V3, etc (1 min. ago)
  • 16 seconds - hCAPTCHA & others (1 min. ago)
Chrome and Firefox logos
Browser extensions available

Updates

  1. Apr 26: RESOLVED - The deathbycaptcha.com website (the API remained/remains fully functional) was sporadically inaccessible due to network issues on April 25th & 26th. This situation was fully resolved and everything is back to 100%.
  2. Feb 26: NEW TYPE ADDED - Now supporting Friendly CAPTCHA!! See the details at https://deathbycaptcha.com/api/friendly
  3. Nov 22: Now supporting Amazon WAF!! See the details at https://deathbycaptcha.com/api/amazonwaf

  4. Previous updates…

Support

Our system is designed to be completely user-friendly and easy-to-use. Should you have any trouble with it, simply email us at DBC technical support emailcom, and a support agent will get back to you as soon as possible.

Live Support

Available Monday to Friday (10am to 4pm EST) Live support image. Link to live support page