### Install SolverCAPTCHA JavaScript using NPM or Yarn

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Demonstrates how to install the SolverCAPTCHA JavaScript package using either NPM or Yarn package managers. It also shows how to install directly from a GitHub repository.

```shell
npm install solvecaptcha-javascript
```

```shell
yarn add solvecaptcha-javascript
```

```shell
npm install github:solvercaptcha/solvecaptcha-javascript
```

--------------------------------

### GET /api/user/balance

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Checks the balance of your account.

```APIDOC
## GET /api/user/balance

### Description
Checks the balance of your account.

### Method
GET

### Endpoint
/api/user/balance

### Parameters
No parameters required.

### Response
#### Success Response (200)
- **balance** (number) - The current account balance.

#### Response Example
```json
{
  "balance": 10.50
}
```
```

--------------------------------

### Get ClickCaptcha Coordinates

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Provides coordinates for specific points on a captcha image, useful for tasks requiring clicks on image areas. Requires the image in base64 format and text instructions.

```javascript
const imageBase64 = fs.readFileSync("./tests/media/coordinates.jpg", "base64")

solver.coordinates({
    body: imageBase64,
    textinstructions: 'Select all photos containing the boat'
 })
.then((res) => {
    console.log(res);
})
.catch((err) => {
    console.log(err);
})
```

--------------------------------

### Initialize SolverCAPTCHA Solver with API Key

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Shows how to create an instance of the Solver class from the 'solvecaptcha-javascript' library. It requires your personal SolverCAPTCHA API key for authentication.

```javascript
const SolveCaptcha = require("solvecaptcha-javascript")
const solver = new SolveCaptcha.Solver("<Your solvecaptcha api key>")
```

--------------------------------

### Build Project with npm

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/RELEASING.md

Builds the project using the npm run script defined in package.json. This command is essential before updating the package version.

```bash
npm run build
```

--------------------------------

### Configure SolverCAPTCHA Solver with API Key and Polling Interval

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Illustrates how to initialize the Solver class with both an API key and a custom polling interval. The polling interval determines the delay between API requests.

```javascript
const apiKey = 'YOUR_API_KEY'
const pollingInterval = 10

const solver = new SolveCaptcha.Solver(apiKey, pollingInterval)
```

--------------------------------

### Push Changes and Tags to Git

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/RELEASING.md

Pushes the committed changes to the master branch and includes all generated tags, which triggers the automated publishing process via GitHub Actions.

```bash
git push origin master --tags
```

--------------------------------

### Clone Repository

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/CONTRIBUTING.md

Clones the solvecaptcha-javascript repository from GitHub to your local machine.

```bash
git clone https://github.com/solvercaptcha/solvecaptcha-javascript.git
```

--------------------------------

### Bounding Box Method for Image Highlighting

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Highlights specific objects in an image by providing the image (as a data URL or base64) and instructions (text or base64 image).

```javascript
solver.boundingBox({
  image: "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAR4AAACwCAIAAAB...",
  textinstructions: "Circle all the cars in the image.",
})
.then((res) => {
    console.log(res);
})
.catch((err) => {
    console.log(err);
})
```

--------------------------------

### Bounding Box Image Markup

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Highlights specific objects in an image by drawing a bounding box. Requires either text or image instructions for markup.

```APIDOC
## Bounding Box Image Markup

### Description
Highlights specific objects in an image by drawing a bounding box. Requires either text or image instructions for markup.

### Method
POST

### Endpoint
/solver/bounding_box

### Parameters
#### Request Body
- **image** (string) - Required - The image data (e.g., base64 encoded).
- **textinstructions** (string) - Optional - Text instructions for markup.
- **imginstructions** (string) - Optional - Image instructions for markup (base64 encoded).

### Request Example
```json
{
  "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAR4AAACwCAIAAAB...",
  "textinstructions": "Circle all the cars in the image."
}
```

### Response
#### Success Response (200)
- **boundingBoxes** (array) - An array of bounding box coordinates for the identified objects.

#### Response Example
```json
{
  "boundingBoxes": [
    {"x": 10, "y": 20, "width": 50, "height": 60},
    {"x": 70, "y": 80, "width": 90, "height": 100}
  ]
}
```
```

--------------------------------

### Canvas Method for Outlining Objects

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Outlines objects in an image by drawing a polygon, returning coordinates. Requires the image, instructions (text or base64 image), and optionally text instructions.

```javascript
solver.canvas({
    body: 'iVBORw0KGgoAAAANSgAAAcIA...',
    imginstructions: '/9j/4AAQSkZJRgABAQEA...',
    textinstructions: 'Highlight the red CIRCLE'
})
.then((res) => {
    console.log(res);
})
.catch((err) => {
    console.log(err);
})
```

--------------------------------

### Solve KeyCaptcha with JavaScript

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Handles token-based KeyCaptcha challenges. Requires page URL, user ID, session ID, and server signature keys. Returns a token to bypass verification. Dependencies: Page URL, userId, sessionId, webServerSign, webServerSign2.

```javascript
solver.keyCaptcha({
    pageurl: "https://solvecaptcha.com/demo/keycaptcha",
    userId: '184015',
    sessionId: '0917788cad24ad3a69813c4fcd556061',
    webServerSign: '02f7f9669f1269595c4c69bcd4a3c52e',
    webServerSign2: 'd888700f6f324ec0f32b44c32c50bde1'
})
.then((res) => {
    console.log(res);
})
.catch((err) => {
    console.log(err);
})
```

--------------------------------

### POST /api/solver/keyCaptcha

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Token-based method for solving KeyCaptcha challenges.

```APIDOC
## POST /api/solver/keyCaptcha

### Description
Token-based method for solving KeyCaptcha challenges.

### Method
POST

### Endpoint
/api/solver/keyCaptcha

### Parameters
#### Request Body
- **pageurl** (string) - Required - The URL of the page with the KeyCaptcha.
- **userId** (string) - Required - The user ID for KeyCaptcha.
- **sessionId** (string) - Required - The session ID for KeyCaptcha.
- **webServerSign** (string) - Required - The web server signature for KeyCaptcha.
- **webServerSign2** (string) - Required - The second web server signature for KeyCaptcha.

### Request Example
```json
{
    "pageurl": "https://solvecaptcha.com/demo/keycaptcha",
    "userId": '184015',
    "sessionId": '0917788cad24ad3a69813c4fcd556061',
    "webServerSign": '02f7f9669f1269595c4c69bcd4a3c52e',
    "webServerSign2": 'd888700f6f324ec0f32b44c32c50bde1'
}
```

### Response
#### Success Response (200)
- **captchaToken** (string) - The token to bypass KeyCaptcha verification.

#### Response Example
```json
{
  "captchaToken": "example_token"
}
```
```

--------------------------------

### Solve FunCaptcha with JavaScript

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Solves FunCaptcha (Arkoselabs) and returns a verification token. This method requires the page URL and the public key associated with the FunCaptcha instance.

```javascript
solver.funCaptcha({
  pageurl: "https://funcaptcha.com/tile-game-lite-mode/fc/api/nojs/?pkey=804380F4-6844-FFA1-ED4E-5877CA1F1EA4&lang=en",
  publickey: "804380F4-6844-FFA1-ED4E-5877CA1F1EA4"
})
.then((res) => {
  console.log(res);
})
.catch((err) => {
  console.log(err);
})
```

--------------------------------

### FunCaptcha Solving

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Solves FunCaptcha (Arkoselabs) challenges, returning a verification token.

```APIDOC
## POST /solvercaptcha/funCaptcha

### Description
Solves FunCaptcha (Arkoselabs) challenges and returns a verification token.

### Method
POST

### Endpoint
/solvercaptcha/funCaptcha

### Parameters
#### Request Body
- **pageurl** (string) - Required - The URL of the page containing the FunCaptcha.
- **publickey** (string) - Required - The public key associated with the FunCaptcha.
- **proxy** (object) - Optional - Proxy configuration for the request.
  - **type** (string) - Required if proxy is used - Type of proxy (e.g., 'HTTP', 'SOCKS5').
  - **uri** (string) - Required if proxy is used - Proxy URI in the format 'login:password@IP_address:PORT'.

### Request Example
```javascript
solver.funCaptcha({
  pageurl: "https://funcaptcha.com/tile-game-lite-mode/fc/api/nojs/?pkey=804380F4-6844-FFA1-ED4E-5877CA1F1EA4&lang=en",
  publickey: "804380F4-6844-FFA1-ED4E-5877CA1F1EA4"
})
.then((res) => {
  console.log(res);
})
.catch((err) => {
  console.log(err);
})
```

### Response
#### Success Response (200)
- **captchaId** (string) - The unique identifier for the captcha solving task.
- **code** (integer) - Status code indicating success (e.g., 1 for success).
- **captchaOutput** (string) - The verification token for FunCaptcha.

#### Response Example
```json
{
  "captchaId": "some_captcha_id",
  "code": 1,
  "captchaOutput": "FUN_CAPTCHA_TOKEN"
}
```
```

--------------------------------

### Update Package Version with npm

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/RELEASING.md

Updates the package version in package.json. Supports patch, minor, and major version bumps. This command also creates a commit and a new tag for the release.

```bash
npm version patch
```

```bash
npm version minor
```

```bash
npm version major
```

--------------------------------

### Solve atbCAPTCHA with JavaScript

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Solves atbCAPTCHA challenges and returns a bypass token. Requires the page URL, application ID, and API server address. Dependencies: Page URL, appId, apiServer.

```javascript
solver.atbCaptcha({
    pageurl: "https://mysite.com/page/with/atbCAPTCHA",
    appId: "af25e409b33d722a95e56a230ff8771c",
    apiServer: "https://cap.aisecurius.com"
})
.then((res) => {
console.log(res);
})
.catch((err) => {
console.log(err);
})
```

--------------------------------

### POST /api/solver/audio

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Solves an audio captcha (only mp3 format is supported). You must specify the language using lang = 'en'. Supported languages include: "en", "ru", "de", "el", "pt", and "fr".

```APIDOC
## POST /api/solver/audio

### Description
Solves an audio captcha (only mp3 format is supported). You must specify the language using lang = 'en'. Supported languages include: "en", "ru", "de", "el", "pt", and "fr".

### Method
POST

### Endpoint
/api/solver/audio

### Parameters
#### Request Body
- **body** (string) - Required - Base64 encoded audio data (mp3 format).
- **lang** (string) - Required - The language of the audio captcha (e.g., 'en', 'ru', 'de', 'el', 'pt', 'fr').

### Request Example
```json
{
  "body": "SUQzBAAAAAAAHFRTU0UAAAA...",
  "lang": "en"
}
```

### Response
#### Success Response (200)
- **transcript** (string) - The transcribed text from the audio captcha.

#### Response Example
```json
{
  "transcript": "example transcription"
}
```
```

--------------------------------

### Proxy Integration

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Proxies can be included as an additional parameter when solving captchas to assist in the solving process.

```APIDOC
## Proxy Integration

### Description
Proxies can be included as an additional parameter when solving captchas to assist in the solving process. This is supported for various captcha types including reCAPTCHA, FunCaptcha, GeeTest, KeyCaptcha, and others.

### Example (reCAPTCHA V2 with proxy)
```javascript
solver.recaptcha({
    pageurl: 'https://solvecaptcha.com/demo/recaptcha-v2',
    googlekey: '6LfD3PIbAAAAAJs_eEHvoOl75_83eXSqpPSRFJ_u',
    proxy: 'HTTPS',
    proxytype: 'login:password@123.123.123.123:3128'
})
```

### Parameters for Proxy
- **proxy** (string) - The proxy type (e.g., 'HTTP', 'HTTPS', 'SOCKS4', 'SOCKS5').
- **proxytype** (string) - The proxy address and port, optionally including login and password (e.g., 'login:password@123.123.123.123:3128').
```

--------------------------------

### MTCaptcha Solving

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Solve MTCaptcha by providing the page URL and the site key. This method returns a token to bypass the verification process.

```APIDOC
## MTCaptcha Solving

### Description
Solve MTCaptcha by providing the page URL and the site key. This method returns a token to bypass the verification process.

### Method
POST

### Endpoint
/solver/mtcaptcha

### Parameters
#### Request Body
- **pageurl** (string) - Required - The URL of the page with the MTCaptcha.
- **sitekey** (string) - Required - The public site key for MTCaptcha.

### Request Example
```json
{
  "pageurl": "https://service.mtcaptcha.com/mtcv1/demo/index.html",
  "sitekey": "MTPublic-DemoKey9M"
}
```

### Response
#### Success Response (200)
- **token** (string) - The token to bypass verification.

#### Response Example
```json
{
  "token": "YOUR_CAPTCHA_TOKEN"
}
```
```

--------------------------------

### Solve Cutcaptcha with JavaScript

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Solves Cutcaptcha challenges, returning the solution in JSON format. Requires the page URL and specific API keys. Dependencies: Page URL, misery_key, api_key.

```javascript
solver.cutCaptcha({
    pageurl: "https://mysite.com/page/with/cutcaptcha",
    misery_key: "098e6a849af406142e3150dbf4e6d0538db2b51f", 
    api_key: "SAs61IAI",
})
.then((res) => {
console.log(res);
})
.catch((err) => {
console.log(err);
})
```

--------------------------------

### Solve Audio Captcha with JavaScript

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Bypasses audio CAPTCHAs, supporting only MP3 format. Requires base64 encoded audio data and a language code (e.g., 'en', 'ru'). Dependencies: Audio data (base64), language code.

```javascript
solver.audio({
  body: "SUQzBAAAAAAAHFRTU0UAAAA...",
  lang: "en"
})
.then((res) => {
  console.log(res);
})
.catch((err) => {
  console.log(err);
})
```

--------------------------------

### Canvas Image Markup

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Outlines an object in an image by drawing a polygon. Returns coordinates for the polygon points.

```APIDOC
## Canvas Image Markup

### Description
Outlines an object in an image by drawing a polygon. Returns coordinates for the polygon points.

### Method
POST

### Endpoint
/solver/canvas

### Parameters
#### Request Body
- **body** (string) - Required - The image data (e.g., base64 encoded).
- **imginstructions** (string) - Required - Base64 encoded image instructions for markup.
- **textinstructions** (string) - Required - Text instructions for markup.

### Request Example
```json
{
  "body": "iVBORw0KGgoAAAANSgAAAcIA...",
  "imginstructions": "/9j/4AAQSkZJRgABAQEA...",
  "textinstructions": "Highlight the red CIRCLE"
}
```

### Response
#### Success Response (200)
- **coordinates** (array) - An array of coordinate pairs [x, y] defining the polygon.

#### Response Example
```json
{
  "coordinates": [
    [50, 50],
    [100, 70],
    [80, 120]
  ]
}
```
```

--------------------------------

### Solve GeeTest Captcha with JavaScript

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Solves GeeTest puzzle captcha and returns a JSON object with the necessary tokens. It requires the page URL, `gt` key, and a `challenge` value, which needs to be obtained dynamically for each request.

```javascript
// Read more about `challenge` on the page https://solvecaptcha.com/p/geetest
solver.geetest({
  pageurl: 'https://solvecaptcha.com/demo/geetest',
  gt: '81388ea1fc187e0c335c0a8907ff2625',
  challenge: '<you need to get a new challenge value each time>'
})
.then((res) => {
  console.log(res);
})
.catch((err) => {
  console.log(err);
})
```

--------------------------------

### Solve reCAPTCHA V3 with JavaScript

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Solves reCAPTCHA V3, returning a token for verification. It requires the page URL and Google site key, and allows specifying a minimum score, version, and action. This is used for solving reCAPTCHA V3.

```javascript
solver.recaptcha({
    pageurl: 'https://solvecaptcha.com/demo/recaptcha-v3',
    googlekey: '6Lcyqq8oAAAAAJE7eVJ3aZp_hnJcI6LgGdYD8lge',
    version: "v3",
    min_score: "0.4",
    action: 'demo_action'
})
.then((res) => {
  console.log(res);
})
.catch((err) => {
  console.log(err);
})
```

--------------------------------

### Yandex Smart Captcha

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Solves Yandex Smart Captcha and provides a token to bypass verification. Requires the page URL and the sitekey.

```APIDOC
## Yandex Smart Captcha

### Description
Use this method to solve Yandex Smart Captcha and receive a token that allows you to bypass the verification.

### Method
POST

### Endpoint
`/solver/yandexSmart`

### Parameters
#### Request Body
- **pageurl** (string) - Required - The URL of the page where the captcha is located.
- **sitekey** (string) - Required - The sitekey provided by Yandex for the captcha.

### Request Example
```json
{
  "pageurl": "https://captcha-api.yandex.ru/demo",
  "sitekey": "FEXfAbHQsToo97VidNVk3j4dC74nGW1DgdxjtNB9"
}
```

### Response
#### Success Response (200)
- **captchaToken** (string) - The token to bypass Yandex Smart Captcha.

#### Response Example
```json
{
  "captchaToken": "yandex_smart_captcha_token_example"
}
```
```

--------------------------------

### Solve Tencent Captcha with JavaScript

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Solves Tencent CAPTCHA, providing the response in JSON format. Requires the page URL and the application ID. Dependencies: Page URL, appId.

```javascript
solver.tencent({
    pageurl: "https://mysite.com/page/with/tencent",
    appId: "189956587"  
})
.then((res) => {
console.log(res);
})
.catch((err) => {
console.log(err);
})
```

--------------------------------

### Amazon WAF

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Solves Amazon WAF (AWS WAF) Captcha, returning a token for bypassing threat mitigation. Requires page URL, sitekey, context, and initialization vector (iv).

```APIDOC
## Amazon WAF

### Description
Use this method to solve Amazon WAF Captcha, also known as AWS WAF Captcha, which is part of Amazon AWS's intelligent threat mitigation system. Returns a JSON response containing the token.

### Method
POST

### Endpoint
`/solver/amazonWaf`

### Parameters
#### Request Body
- **pageurl** (string) - Required - The URL of the page with the Amazon WAF captcha.
- **sitekey** (string) - Required - The sitekey for the Amazon WAF captcha.
- **context** (string) - Required - Dynamic context information retrieved from the page.
- **iv** (string) - Required - The Initialization Vector used in encryption.

### Request Example
```json
{
  "pageurl": "https://non-existent-example.execute-api.us-east-1.amazonaws.com/latest",
  "sitekey": "AQIDAHjcYu/GjX+QlghicBgQ/7bFaQZ+m5FKCMDnO+vTbNg96AHMDLodoefdvyOnsHMRt...",
  "context": "9BUgmlm48F92WUoqv97a49ZuEJJ50TCk9MVr3C7WMtQ0X6flVbufM4n8mjFLmbLVAPgaQ...",
  "iv": "CgAHbCe2GgAAAAAj"
}
```

### Response
#### Success Response (200)
- **captchaToken** (string) - The token to bypass Amazon WAF Captcha.

#### Response Example
```json
{
  "captchaToken": "aws_waf_token_example"
}
```
```

--------------------------------

### Solve MTCaptcha

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Solves MTCaptcha by providing the page URL and site key. Returns a token for verification bypass.

```javascript
solver.mtCaptcha({
    pageurl: "https://service.mtcaptcha.com/mtcv1/demo/index.html",
    sitekey: "MTPublic-DemoKey9M"
})
.then((res) => {
console.log(res);
})
.catch((err) => {
console.log(err);
})
```

--------------------------------

### Create New Branch

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/CONTRIBUTING.md

Creates a new Git branch for feature development or bug fixes, helping to isolate changes.

```bash
git checkout -b my-feature-branch
```

--------------------------------

### Solve Cloudflare Turnstile Captcha with JavaScript

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Solves Cloudflare Turnstile captchas, returning a JSON response with the solution token. Requires the page URL and site key.

```javascript
solver.cloudflareTurnstile({
    pageurl: "https://app.nodecraft.com/login",
    sitekey: "0x4AAAAAAAAkg0s3VIOD10y4"    
})
.then((res) => {
    console.log(res);
})
.catch((err) => {
    console.log(err);
})
```

--------------------------------

### Solve reCAPTCHA V2 with Proxy in JavaScript

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Solves reCAPTCHA V2 while utilizing a proxy server for the request. Requires page URL, Google site key, proxy type, and proxy details (login:password@IP:port).

```javascript
solver.recaptcha({
    pageurl: 'https://solvecaptcha.com/demo/recaptcha-v2',
    googlekey: '6LfD3PIbAAAAAJs_eEHvoOl75_83eXSqpPSRFJ_u',
    proxy: 'HTTPS',
    proxytype: 'login:password@123.123.123.123:3128'
})
```

--------------------------------

### Solve Yandex Smart Captcha with JavaScript

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Solves Yandex Smart Captchas, returning a token necessary for bypassing verification. Requires the page URL and site key.

```javascript
solver.yandexSmart({
  pageurl: "https://captcha-api.yandex.ru/demo",
  sitekey: "FEXfAbHQsToo97VidNVk3j4dC74nGW1DgdxjtNB9"
 })
.then((res) => {
  console.log(res);
})
.catch((err) => {
  console.log(err);
})
```

--------------------------------

### POST /api/solver/tencent

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Solves Tencent captcha. The response is provided in JSON format.

```APIDOC
## POST /api/solver/tencent

### Description
Solves Tencent captcha. The response is provided in JSON format.

### Method
POST

### Endpoint
/api/solver/tencent

### Parameters
#### Request Body
- **pageurl** (string) - Required - The URL of the page with the Tencent captcha.
- **appId** (string) - Required - The App ID for Tencent captcha.

### Request Example
```json
{
    "pageurl": "https://mysite.com/page/with/tencent",
    "appId": "189956587"  
}
```

### Response
#### Success Response (200)
- **captchaToken** (string) - The token to bypass Tencent captcha verification.

#### Response Example
```json
{
  "captchaToken": "example_token"
}
```
```

--------------------------------

### GeeTest Captcha Solving

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Solves GeeTest puzzle captcha challenges and returns the necessary tokens for verification.

```APIDOC
## POST /solvercaptcha/geetest

### Description
Solves GeeTest puzzle captcha challenges, returning a JSON object containing the required tokens for verification.

### Method
POST

### Endpoint
/solvercaptcha/geetest

### Parameters
#### Request Body
- **pageurl** (string) - Required - The URL of the page containing the GeeTest captcha.
- **gt** (string) - Required - The public GeeTest key (gt).
- **challenge** (string) - Required - The GeeTest challenge value, which must be obtained dynamically for each solving attempt.
- **proxy** (object) - Optional - Proxy configuration for the request.
  - **type** (string) - Required if proxy is used - Type of proxy (e.g., 'HTTP', 'SOCKS5').
  - **uri** (string) - Required if proxy is used - Proxy URI in the format 'login:password@IP_address:PORT'.

### Request Example
```javascript
// Read more about `challenge` on the page https://solvecaptcha.com/p/geetest
solver.geetest({
  pageurl: 'https://solvecaptcha.com/demo/geetest',
  gt: '81388ea1fc187e0c335c0a8907ff2625',
  challenge: '<you need to get a new challenge value each time>'
})
.then((res) => {
  console.log(res);
})
.catch((err) => {
  console.log(err);
})
```

### Response
#### Success Response (200)
- **captchaId** (string) - The unique identifier for the captcha solving task.
- **code** (integer) - Status code indicating success (e.g., 1 for success).
- **captchaOutput** (object) - An object containing the GeeTest solution tokens.
  - **geetest_challenge** (string) - The GeeTest challenge token.
  - **geetest_validate** (string) - The GeeTest validate token.
  - **geetest_seccode** (string) - The GeeTest seccode token.

#### Response Example
```json
{
  "captchaId": "some_captcha_id",
  "code": 1,
  "captchaOutput": {
    "geetest_challenge": "GEETEST_CHALLENGE_TOKEN",
    "geetest_validate": "GEETEST_VALIDATE_TOKEN",
    "geetest_seccode": "GEETEST_SECCODE_TOKEN"
  }
}
```
```

--------------------------------

### POST /api/solver/cutCaptcha

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Solves Cutcaptcha. The response is returned in JSON format.

```APIDOC
## POST /api/solver/cutCaptcha

### Description
Solves Cutcaptcha. The response is returned in JSON format.

### Method
POST

### Endpoint
/api/solver/cutCaptcha

### Parameters
#### Request Body
- **pageurl** (string) - Required - The URL of the page with the Cutcaptcha.
- **misery_key** (string) - Required - The misery key for Cutcaptcha.
- **api_key** (string) - Required - The API key for Cutcaptcha.

### Request Example
```json
{
    "pageurl": "https://mysite.com/page/with/cutcaptcha",
    "misery_key": "098e6a849af406142e3150dbf4e6d0538db2b51f", 
    "api_key": "SAs61IAI"
}
```

### Response
#### Success Response (200)
- **captchaToken** (string) - The token to bypass Cutcaptcha verification.

#### Response Example
```json
{
  "captchaToken": "example_token"
}
```
```

--------------------------------

### Commit Changes

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/CONTRIBUTING.md

Commits staged changes to the Git repository with a descriptive message explaining the modifications.

```bash
git commit -m "Add feature X to bypass challenge"
```

--------------------------------

### Solve DataDome CAPTCHA with JavaScript

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Solves DataDome CAPTCHAs, returning a token to bypass protection. Requires page URL, captcha URL, user agent, and proxy details (address, type). A proxy is mandatory for this method.

```javascript
solver.dataDome({
    pageurl: "https://rendezvousparis.hermes.com/client/register",
    captcha_url: "https://geo.captcha-delivery.com/captcha/?initialCid=AHrlqAAAAAMAEuQtkf4k1c0ABZhYZA%3D%3D&hash=789361B674144528D0B7EE76B35826&cid=mY4z7GNmh7Nt1lAFwpbNHAOcWPhyPgjHD2K1Pm~Od1iEKYLUnK3t7N2ZGUj8OqDK65cnwJHtHwd~t902vlwpSBA5l4ZHbS1Qszv~jEuEUJNQ_jMAjar2Kj3kq20MRJYh&t=fe&referer=https%3A%2F%2Frendezvousparis.hermes.com%2Fclient%2Fregister&s=40119&e=67fef144ac1a54dbd7507776367d2f9d5e36ec3add17fa22f3cb881db8385838",
    userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/118.0.0.0 Safari/537.36",
    proxy: "login:password@1.2.3.4:8888", // The (Username : Password @ Address : Port) of our chosen proxy
    proxytype: "http" // The 'Type' of proxy, http, https, socks, ect.
})
.then((res) => {
console.log(res);
})
.catch((err) => {
console.log(err);
})
```

--------------------------------

### Check Account Balance with JavaScript

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Checks the current account balance. No parameters are required.

```javascript
solver.balance()
.then((res) => {
    console.log(res)
})
```

--------------------------------

### POST /api/report/goodReport

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Reports a correct captcha solution. Requires the captcha ID.

```APIDOC
## POST /api/report/goodReport

### Description
Reports a correct captcha solution. Requires the captcha ID.

### Method
POST

### Endpoint
/api/report/goodReport

### Parameters
#### Request Body
- **captchaId** (string) - Required - The ID of the captcha solution to report as correct.

### Request Example
```json
{
  "captchaId": "7031846604"
}
```

### Response
#### Success Response (200)
- **message** (string) - Confirmation message indicating the report was successful.

#### Response Example
```json
{
  "message": "Captcha reported as correct."
}
```
```

--------------------------------

### POST /api/solver/atbCaptcha

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Solves the atbCAPTCHA challenge. It returns a token that allows you to bypass the captcha verification.

```APIDOC
## POST /api/solver/atbCaptcha

### Description
Solves the atbCAPTCHA challenge. It returns a token that allows you to bypass the captcha verification.

### Method
POST

### Endpoint
/api/solver/atbCaptcha

### Parameters
#### Request Body
- **pageurl** (string) - Required - The URL of the page with the atbCAPTCHA.
- **appId** (string) - Required - The App ID for atbCAPTCHA.
- **apiServer** (string) - Required - The API server URL for atbCAPTCHA.

### Request Example
```json
{
    "pageurl": "https://mysite.com/page/with/atbCAPTCHA",
    "appId": "af25e409b33d722a95e56a230ff8771c",
    "apiServer": "https://cap.aisecurius.com"
}
```

### Response
#### Success Response (200)
- **captchaToken** (string) - The token to bypass atbCAPTCHA verification.

#### Response Example
```json
{
  "captchaToken": "example_token"
}
```
```

--------------------------------

### Solve CyberSiARA Captcha

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Solves CyberSiARA captchas by providing the page URL, a master URL ID, and the user agent. Returns a token to bypass verification.

```javascript
solver.cyberSiARA({
    pageurl: "https://www.cybersiara.com/book-a-demo",
    master_url_id: "OXR2LVNvCuXykkZbB8KZIfh162sNT8S2",
    userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/118.0.0.0 Safari/537.36"
})
.then((res) => {
console.log(res);
})
.catch((err) => {
console.log(err);
})
```

--------------------------------

### Solve Lemin Cropped Captcha with JavaScript

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Solves Lemin Cropped Captchas, providing a token to bypass the verification process. Requires page URL, captcha ID, and the target div ID.

```javascript
solver.lemin({
  pageurl:'https://solvecaptcha.com/demo/lemin', 
  captcha_id: 'CROPPED_3dfdd5c_d1872b526b794d83ba3b365eb15a200b',
  div_id: 'lemin-cropped-captcha',
  api_server: 'api.leminnow.com'
})
.then((res) => {
  console.log(res);
})
.catch((err) => {
  console.log(err);
})
```

--------------------------------

### Cloudflare Turnstile

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Solves Cloudflare Turnstile captchas and returns a JSON response with the token. Handles standard Turnstile and Challenge pages.

```APIDOC
## Cloudflare Turnstile

### Description
Use this method to solve Cloudflare Turnstile captcha. Returns a JSON response containing the token.

### Method
POST

### Endpoint
`/solver/cloudflareTurnstile`

### Parameters
#### Request Body
- **pageurl** (string) - Required - The URL of the page with the Turnstile captcha.
- **sitekey** (string) - Required - The sitekey for the Cloudflare Turnstile captcha.

### Request Example
```json
{
    "pageurl": "https://app.nodecraft.com/login",
    "sitekey": "0x4AAAAAAAAkg0s3VIOD10y4"
}
```

### Response
#### Success Response (200)
- **challengeResponse** (string) - The token required to bypass Cloudflare Turnstile.

#### Response Example
```json
{
  "challengeResponse": "cf_turnstile_token_example"
}
```
```

--------------------------------

### Solve GeeTest V4 Captcha with JavaScript

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Solves GeeTest V4 captchas by sending the page URL and captcha ID to the SolverCaptcha API. It returns a JSON response containing the solution or an error.

```javascript
solver.geetestV4({
  pageurl: 'https://solvecaptcha.com/demo/geetest-v4',
  captcha_id: 'e392e1d7fd421dc63325744d5a2b9c73'
})
.then((res) => {
  console.log(res);
})
.catch((err) => {
  console.log(err);
})
```

--------------------------------

### reCAPTCHA V2 Solving

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Solves reCAPTCHA V2 challenges and returns a token necessary for bypassing verification on websites.

```APIDOC
## POST /solvercaptcha/recaptcha

### Description
Solves reCAPTCHA V2 challenges and provides a token to bypass website verification.

### Method
POST

### Endpoint
/solvercaptcha/recaptcha

### Parameters
#### Request Body
- **pageurl** (string) - Required - The URL of the page where the reCAPTCHA V2 is located.
- **googlekey** (string) - Required - The site key (also known as googlekey) for the reCAPTCHA V2 widget, found in the page's HTML.
- **version** (string) - Optional - Specify "v2" for reCAPTCHA V2. Defaults to "v2".
- **proxy** (object) - Optional - Proxy configuration for the request.
  - **type** (string) - Required if proxy is used - Type of proxy (e.g., 'HTTP', 'SOCKS5').
  - **uri** (string) - Required if proxy is used - Proxy URI in the format 'login:password@IP_address:PORT'.

### Request Example
```javascript
solver.recaptcha({
  pageurl: 'https://solvecaptcha.com/demo/recaptcha-v2',
  googlekey: '6LfD3PIbAAAAAJs_eEHvoOl75_83eXSqpPSRFJ_u'
})
.then((res) => {
  console.log(res);
})
.catch((err) => {
  console.log(err);
})
```

### Response
#### Success Response (200)
- **captchaId** (string) - The unique identifier for the captcha solving task.
- **code** (integer) - Status code indicating success (e.g., 1 for success).
- **captchaOutput** (string) - The verification token for reCAPTCHA V2.

#### Response Example
```json
{
  "captchaId": "some_captcha_id",
  "code": 1,
  "captchaOutput": "SOLVED_TOKEN"
}
```
```

--------------------------------

### CyberSiARA Captcha Solving

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Solve CyberSiARA captchas by providing the page URL, a master URL ID, and the user agent. This method returns a token to bypass verification.

```APIDOC
## CyberSiARA Captcha Solving

### Description
Solve CyberSiARA captchas by providing the page URL, a master URL ID, and the user agent. This method returns a token to bypass verification.

### Method
POST

### Endpoint
/solver/cybersiara

### Parameters
#### Request Body
- **pageurl** (string) - Required - The URL of the page where the captcha appears.
- **master_url_id** (string) - Required - The master URL ID for CyberSiARA.
- **userAgent** (string) - Required - The user agent string of the browser.

### Request Example
```json
{
  "pageurl": "https://www.cybersiara.com/book-a-demo",
  "master_url_id": "OXR2LVNvCuXykkZbB8KZIfh162sNT8S2",
  "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/118.0.0.0 Safari/537.36"
}
```

### Response
#### Success Response (200)
- **token** (string) - The token to bypass verification.

#### Response Example
```json
{
  "token": "YOUR_CAPTCHA_TOKEN"
}
```
```

--------------------------------

### reCAPTCHA V3 Solving

Source: https://github.com/solvercaptcha/solvecaptcha-javascript/blob/master/README.md

Solves reCAPTCHA V3 challenges, returning a token and optionally considering a minimum score and specific action.

```APIDOC
## POST /solvercaptcha/recaptcha

### Description
Solves reCAPTCHA V3 challenges, returning a token that can be used for verification. Allows specifying a minimum score threshold and the action name.

### Method
POST

### Endpoint
/solvercaptcha/recaptcha

### Parameters
#### Request Body
- **pageurl** (string) - Required - The URL of the page where the reCAPTCHA V3 is located.
- **googlekey** (string) - Required - The site key (also known as googlekey) for the reCAPTCHA V3 widget.
- **version** (string) - Required - Must be set to "v3" to solve reCAPTCHA V3.
- **min_score** (string) - Optional - The minimum score required for the reCAPTCHA V3 verification. If the score is lower, the captcha might not be solved successfully. Defaults to '0.3'.
- **action** (string) - Optional - The action name associated with the reCAPTCHA V3 verification. Defaults to 'homepage'.
- **proxy** (object) - Optional - Proxy configuration for the request.
  - **type** (string) - Required if proxy is used - Type of proxy (e.g., 'HTTP', 'SOCKS5').
  - **uri** (string) - Required if proxy is used - Proxy URI in the format 'login:password@IP_address:PORT'.

### Request Example
```javascript
solver.recaptcha({
    pageurl: 'https://solvecaptcha.com/demo/recaptcha-v3',
    googlekey: '6Lcyqq8oAAAAAJE7eVJ3aZp_hnJcI6LgGdYD8lge',
    version: "v3",
    min_score: "0.4",
    action: 'demo_action'
})
.then((res) => {
  console.log(res);
})
.catch((err) => {
  console.log(err);
})
```

### Response
#### Success Response (200)
- **captchaId** (string) - The unique identifier for the captcha solving task.
- **code** (integer) - Status code indicating success (e.g., 1 for success).
- **captchaOutput** (string) - The verification token for reCAPTCHA V3.

#### Response Example
```json
{
  "captchaId": "some_captcha_id",
  "code": 1,
  "captchaOutput": "SOLVED_TOKEN_V3"
}
```
```