Join And Get Free Trial!

Home/how-to-integrate-nextcaptcha-with-gsa-captcha-breaker

How to Integrate NextCaptcha captcha service with GSA Captcha Breaker in 2024#

logoNextCaptcha
August 15,2024

Integrating NextCaptcha with GSA Captcha Service allows you to leverage NextCaptcha's advanced captcha-solving capabilities within your automated workflows. Below is a step-by-step guide on how to achieve this integration.

Prerequisites#

Before you start, ensure you have the following:
  • A working GSA Captcha Breaker setup.
  • An active NextCaptcha account with API access.
  • Basic knowledge of GSA Captcha Breaker and NextCaptcha API.

Step 1: Obtain API Key from NextCaptcha#

  • Log in to your NextCaptcha account.

  • Navigate to the **API** section.

  • Copy your API key; you will need this to authenticate your requests to NextCaptcha

Step 2: Configure GSA Captcha Breaker#

  • Open GSA Captcha Breaker on your system.

  • click **Options** tab.

  • Go to the **Captcha** tab.

  • Click on the **Add** button to create a new captcha service.

  • In the **Service Name** field, select 'NextCaptcha'

  • In the **API-key** field, enter the API key provided by NextCaptcha (get from step1).

  • Enter your API key in the corresponding field.

Step 3: Set Up the API Request#

  • GSA Captcha Breaker will need to send a POST request to NextCaptcha's API. Configure the request in GSA as follows: Here is an example of what the config.ini might look like: 

     
     [setup]
     ;default settings
 
     ;name of this service (default is ini file name)
     ;name=
 
     ;where can we register/get more details?
     main url=https://nextcaptcha.com/
 
     ;how would you describe this service
     desc=NextCaptcha.com - Cheap And Fast Recaptcha Solving Service
 
     ;usually all types are supported, if not, specify them here
     image types supported=jpg, png, gif
 
     ;a rating of this service from 1-5
     rating=3
 
     base64 encode=1
 
     ;how much does this cost
     costs=0.0005
 
     ;what internal id is used for GSA products?
     id=61
 
     ;additional hosts to simulate
     simulate host=api.nextcaptcha.com
     simulate port=443
 
     ;******************************************************************************
     [balance]
     ;check balance of account
 
     url=https://api.nextcaptcha.com/getBalance
     post_data={"clientKey":"%API-KEY%"}
     encoding=json
 
     result=%balance_result%
     error=%balance_error%
 
     ;when simulating this service, use the following replies...
     simulate_result={"errorId":0,"balance":999}
     simulate_error={"errorId":10,"status":"ERROR_ZERO_BALANCE"}
 
     ;******************************************************************************
     [recaptcha_solve]
     url=https://api.nextcaptcha.com/createTask
     post_data={"clientKey":"%api-key%","task":{"type":"RecaptchaV2TaskProxyless","websiteURL":"%arg2%","websiteKey":"%arg1%","isInvisible":%arg5%}}
     encoding=json
 
     invisible_on=true
     invisible_off=false
 
     enterprise_on=true
     enterprise_off=false
 
     result=%recaptcha_result%
     error=%captcha_error%
 
     ;when simulating this service, use the following replies...
     simulate_result={"errorId": 0, "taskId": %report_id%}
     simulate_error={"errorId": 12, "errorCode": "ERROR_CAPTCHA_UNSOLVABLE", "errorDescription": "Captcha could not be solved by 5 different workers"}
 
     [recaptcha_solve loop]
     url=https://api.nextcaptcha.com/getTaskResult
     post_data={"clientKey":"%api-key%","taskId": %captcha_id%}
     encoding=json
     delay=5
     timeout=120
 
     simulate_result={"errorId":0, "status":"ready", "solution":{"text":"%result%", "url":""}, "cost":"0.000000", "ip":"1.2.3.4", "createTime":1472205564, "endTime":1472205570, "solveCount":"0"}
     simulate_error={"errorId": 12, "errorCode": "ERROR_CAPTCHA_UNSOLVABLE", "errorDescription": "Captcha could not be solved by 5 different workers"}
     simulate_loop={"errorId":0, "status":"processing"}
 
     ;******************************************************************************
     [recaptcha3_solve]
     url=https://api.nextcaptcha.com/createTask
     post_data={"clientKey":"%api-key%","task":{"type":"RecaptchaV3TaskProxyless","websiteURL":"%arg2%","websiteKey":"%arg1%","minScore":%arg4%,"pageAction":"%arg3%"}}
     encoding=json
 
     result=%recaptcha_result%
     error=%captcha_error%
 
     enterprise_on=true
     enterprise_off=false
 
 
     ;when simulating this service, use the following replies...
     simulate_result={"errorId": 0, "taskId": %report_id%}
     simulate_error={"errorId": 12, "errorCode": "ERROR_CAPTCHA_UNSOLVABLE", "errorDescription": "Captcha could not be solved by 5 different workers"}
 
     [recaptcha3_solve loop]
     url=https://api.nextcaptcha.com/getTaskResult
     post_data={"clientKey":"%api-key%","taskId": %captcha_id%}
     encoding=json
     delay=5
     timeout=120
 
     simulate_result={"errorId":0, "status":"ready", "solution":{"text":"%result%", "url":""}, "cost":"0.000000", "ip":"1.2.3.4", "createTime":1472205564, "endTime":1472205570, "solveCount":"0"}
     simulate_error={"errorId": 12, "errorCode": "ERROR_CAPTCHA_UNSOLVABLE", "errorDescription": "Captcha could not be solved by 5 different workers"}
     simulate_loop={"errorId":0, "status":"processing"}
 
     [recaptcha_report]
     url=https://api.nextcaptcha.com/reportIncorrectImageCaptcha
     post_data={"clientKey":"%api-key%","taskId": %captcha_id%}
     encoding=json
 
     simulate_result={"errorId":0,"status":"success"}
     simulate_error={"errorId":16,"status":"ERROR_NO_SUCH_CAPCHA_ID"}
 
     ;******************************************************************************
     ;extract variables (default input = last download data)
     ;******************************************************************************
 
     [recaptcha_result]
     front="gRecaptchaResponse":
     back=,|}
     remove=";null
 
     [captcha_error]
     front="errorCode":|"errorDescription":
     back=,|}
     remove="
     remove=";null;CAPCHA_NOT_READY;processing;errorDescription
 
     [captcha_id]
     front="taskId":
     back=,|}
     remove=null
 
     [balance_result]
     front="balance":
     back=,|}
     remove=";null
     translate_result_999=Connection was successful! - However, the result was delivered by GSA Captcha Breaker. Please uncheck the service to be simulated/emulated within GSA Captcha Breaker options.
 
     [balance_error]
     front="errorDescription":|"errorCode":
     back=,|}
     remove=";null
 
     ;******************************************************************************
     ;input variables (defined by 'type=...')
     ;******************************************************************************
 
     [API-Key]
     type=text
     hint=API-KEY to access the service

  • put this config to GSA Captcha service configs folder, The configuration folder is usually located in `C:\Users\Computer__User_Name\AppData\Roaming\GSA Search Engine Ranker\captcha_service\`

Step 4: Testing the Integration#

  • Save the configuration.

  • Close the GSA and reopen it, Run a test within GSA Captcha Breaker to ensure it can communicate with NextCaptcha and receive correct captcha solutions.

  • If everything is set up correctly, GSA Captcha Breaker will now send captcha challenges to NextCaptcha, and use the responses to proceed with your automated tasks.

Step 5: Optimize Settings#

  • Retry Logic: Configure retry logic in GSA Captcha Breaker in case of failed attempts or timeouts.
  • Timeout Settings: Adjust timeout settings to match NextCaptcha's average response time.
  • Cost Management: Monitor your API usage within NextCaptcha to ensure you stay within budget.

Conclusion#

Integrating NextCaptcha with GSA Captcha Breaker is straightforward and enhances your captcha-solving capability by combining GSA’s automation with NextCaptcha's advanced solving techniques. Following these steps will help ensure a smooth and efficient integration. If you encounter any issues, consult the support documentation of both GSA Captcha Breaker and NextCaptcha, or reach out to their support teams for further assistance.