BestCaptchaSolver Java API wrapper

bestcaptchasolverapi is a super easy to use bypass captcha Java API wrapper for bestcaptchasolver.com captcha service

Installation

git clone https://github.com/bestcaptchasolver/bestcaptchasolver-java

Dependencies

org.apache.httpcomponents:httpclient
org.json:json

How to use?

Simply import the library, set the auth details and start using the captcha service:

import com.bestcaptchasolver.BestCaptchaSolverAPI;

Set access_token or username and password (legacy) for authentication

String access_token = "your_access_key";
BestCaptchaSolverAPI bcs = new BestCaptchaSolverAPI(access_token);

Once you've set your authentication details, you can start using the API

Get balance

String balance = bcs.account_balance();
System.out.println(String.Format("Balance: %s", balance));

Submit image captcha

Map<String, String> d = new HashMap<String, String>();
d.put("image", "/home/me/Desktop/captcha.png");     // give it an ABSOLUTE path or b64encoded string
// d.put("is_case", "true");        // if case sensitive set to true, default: false, optional
// d.put("is_phrase", "true");      // if phrase, set to true, default: false, optional
// d.put("is_math", "true");        // true if captcha is math, default: false, optional
// d.put("alphanumeric", "1");      // 1 (digits only) or 2 (letters only), default: all characters, optional
// d.put("minlength", "2");         // minimum length of captcha text, default: any, optional
// d.put("maxlength", "4");         // maximum length of captcha text, default: any, optional
// d.put("affiliate_id", "your_affiliate_id");      // get it from /account
int id = bcs.submit_image_captcha(d);     // works with 2nd parameter as well, case sensitivty

Once you have the captchaID, you can check for it's completion

String image_text = "";
while(image_text.equals(""))
{
    image_text = bcs.retrieve(id).getString("text");
    Thread.sleep(2000);
}

Submit recaptcha details

For recaptcha submission there are two things that are required and some that are optional

• page_url
• site_key
• type (optional, defaults to 1 if not given)
  • 1 - v2
  • 2 - invisible
  • 3 - v3
  • 4 - enterprise v2
  • 5 - enterprise v3
• v3_action (optional)
• v3_min_score (optional)
• domain (optional)
• data_s (optional)
• cookie_input (optional)
• user_agent (optional)
• affiliate_id (optional)
• proxy (optional)

For more details about the parameters check /api page

Map<String,String> rd = new HashMap<String, String>();
rd.put("page_url", PAGE_URL);
rd.put("site_key", SITE_KEY);
id = bcs.submit_recaptcha(rd);     // works with proxy as well, check bottom of page file for examples

Same as before, this returns an ID which is used to regulary check for completion

Submit GeeTest

• domain
• gt
• challenge
• api_server (optional)
• user_agent (optional)
• proxy (optional)

Map<String,String> rd = new HashMap<String, String>();
rd.put("domain", "DOMAIN_HERE");
rd.put("gt", "GT_HERE");
rd.put("challenge", "CHALLENGE_HERE");
// rd.put("api_server", "api server for geetest");   // optional
// rd.put("user_agent", "your user agent");          // UA used in solving captcha
// rd.put("proxy", "user:[email protected]");       // proxy with/out authentication
// rd.put("affiliate_id", "your_affiliate_id");      // get it from /account
int id = bcs.submit_geetest(rd);

Submit GeeTestV4

• domain
• captchaid
• user_agent (optional)
• proxy (optional)

Important: This is not the captchaid that's in our system that you receive while submitting a captcha. Gather this from HTML source of page with geetestv4 captcha, inside the <script> tag you'll find a link that looks like this: https://i.imgur.com/XcZd47y.png

Map<String,String> rd = new HashMap<String, String>();
rd.put("domain", "https://example.com");
rd.put("captchaid", "647f5ed2ed8acb4be36784e01556bb71");
// rd.put("user_agent", "your user agent");          // UA used in solving captcha
// rd.put("proxy", "user:[email protected]");       // proxy with/out authentication
// rd.put("affiliate_id", "your_affiliate_id");      // get it from /account
int id = bcs.submit_geetest_v4(rd);

Submit Capy

• page_url
• site_key
• user_agent (optional)
• proxy (optional)

Map<String,String> rd = new HashMap<String, String>();
rd.put("page_url", "PAGE_URL_HERE");
rd.put("site_key", "SITE_KEY_HERE");
// rd.put("user_agent", "your user agent");          // UA used in solving captcha
// rd.put("proxy", "user:[email protected]");       // proxy with/out authentication
// rd.put("affiliate_id", "your_affiliate_id");      // get it from /account
int id = bcs.submit_capy(rd);

Submit hCaptcha

• page_url
• site_key
• invisible (optional)
• payload (optional)
• domain (optional)
• user_agent (optional)
• proxy (optional)

Map<String,String> rd = new HashMap<String, String>();
rd.put("page_url", "PAGE_URL_HERE");
rd.put("site_key", "SITE_KEY_HERE");
// rd.put("invisible", "1");
// rd.put("payload", "{\"rqdata\": \"from web requests\"}");
// rd.put("domain", "hcaptcha.com");        		 // used in loading hcaptcha interface, optional
// rd.put("user_agent", "your UA");
// rd.put("proxy", "12.34.56.78:1234");
// rd.put("affiliate_id", "your_affiliate_id");      // get it from /account
int id = bcs.submit_hcaptcha(rd);

Submit FunCaptcha (Arkose Labs)

• page_url
• s_url
• site_key
• user_agent (optional)
• proxy (optional)

Map<String,String> rd = new HashMap<String, String>();
rd.put("page_url", "https://abc.com");
rd.put("s_url", "https://api.arkoselabs.com");
rd.put("site_key", "11111111-1111-1111-1111-111111111111");
// rd.put("data", "{\"x\":\"y\"}");      // optional
// rd.put("user_agent", "your user agent");          // UA used in solving captcha
// rd.put("proxy", "user:[email protected]");       // proxy with/out authentication
// rd.put("affiliate_id", "your_affiliate_id");      // get it from /account
int id = bcs.submit_funcaptcha(rd);

Submit Turnstile (Cloudflare)

• page_url
• site_key
• action (optional)
• cdata (optional)
• domain (optional)
• user_agent (optional)
• proxy (optional)

Map<String,String> rd = new HashMap<String, String>();
rd.put("page_url", "PAGE_URL_HERE");
rd.put("site_key", "SITE_KEY_HERE");
// rd.put("action", "taken from page source, optional");
// rd.put("cdata", "taken from page source, optional");
// rd.put("domain", "challenges.cloudflare.com");    // used in loading hcaptcha interface, optional
// rd.put("user_agent", "your UA");                  // optional
// rd.put("proxy", "12.34.56.78:1234");              // optional
// rd.put("affiliate_id", "your_affiliate_id");      // get it from /account
int id = bcs.submit_turnstile(rd);

Submit Task

• template_name
• page_url
• variables
• user_agent (optional)
• proxy (optional)

Map<String,String> rd = new HashMap<String, String>();
rd.put("template_name", "Login test page");
rd.put("page_url", "https://bestcaptchasolver.com/automation/login");
rd.put("variables", "{\"username\": \"xyz\", \"password\": \"0000\"}");
// rd.put("user_agent", "your UA");
// rd.put("proxy", "12.34.56.78:1234");
// rd.put("affiliate_id", "your_affiliate_id");      // optional, get it from /account
int id = bcs.submit_task(rd);

Task pushVariables

Update task variables while it is being solved by the worker. Useful when dealing with data / variables, of which value you don't know, only after a certain step or action of the task. For example, in websites that require 2 factor authentication code.

When the task (while running on workers machine) is getting to an action defined in the template, that requires a variable, but variable was not set with the task submission, it will wait until the variable is updated through push.

The bcs.task_push_variables(captcha_id, push_variables) method can be used as many times as it is needed.

bcs.task_push_variables(id, "{\"tfa_code\": \"3495\"}");

Retrieve response (all captchas)

String gresponse = "";
while (gresponse.equals(""))
{
     gresponse = bcs.retrieve(id).getString("gresponse");	// can be also `text` or `solution` instead of `gresponse`
     Thread.sleep(5000);
}

If reCAPTCHA is submitted with proxy, get proxy status

String proxy_status = bcs.retrieve(id).getString("proxy_status");

Set captcha bad

In case a captcha was wrongly completed, you can use the set_captcha_bad(captchaID) method like this

bcs.set_captcha_bad(45);

Examples

Compile and run the com.example package

Binary

If you don't want to compile your own library, you can check the binary folder for a compiled version. Keep in mind that this might not be the latest version with every release

License

API library is licensed under the MIT License

More information

More details about the server-side API can be found here

^{_{captcha, bypasscaptcha, decaptcher, decaptcha, 2captcha, deathbycaptcha, anticaptcha, bypassrecaptchav2, bypassnocaptcharecaptcha, bypassinvisiblerecaptcha, captchaservicesforrecaptchav2, recaptchav2captchasolver, googlerecaptchasolver, recaptchasolverpython, recaptchabypassscript, bestcaptchasolver}}