solvecaptcha-javascript
Version:
Node.js wrapper for SolveCaptcha.com API. Bypass recaptcha, hcaptcha, cloudflare capthca and more.
1,005 lines • 54 kB
TypeScript
export interface paramsRecaptcha {
pageurl: string;
googlekey: string;
invisible?: 0 | 1;
datas?: string;
domain?: string;
cookies?: string;
userAgent?: string;
header_acao?: boolean;
pingback?: string;
soft_id?: number;
proxy?: string;
proxytype?: string;
action?: string;
enterprise?: 0 | 1;
min_score?: number;
version?: string;
}
export interface paramsHCaptcha {
sitekey: string;
pageurl: string;
header_acao?: boolean;
pingback?: string;
proxy?: string;
proxytype?: string;
invisible?: 0 | 1;
data?: string;
userAgent?: string;
soft_id?: number;
domain?: string;
}
export interface paramsFunCaptcha {
publickey: string;
pageurl: string;
surl?: string;
header_acao?: boolean;
pingback?: string;
proxy?: string;
proxytype?: string;
userAgent?: string;
data?: string;
}
export interface paramsImageCaptcha {
body: string;
phrase?: 0 | 1;
regsense?: 0 | 1;
numeric?: 0 | 1 | 2 | 3 | 4;
calc?: 0 | 1;
min_len?: 0 | string | number;
max_len?: 0 | string | number;
language?: 0 | 1 | 2;
lang?: string;
pingback?: string;
textinstructions?: string;
}
export interface paramsGeetest {
gt: string;
challenge: string;
pageurl: string;
api_server?: string;
offline?: number | boolean;
new_captcha?: number | boolean;
pingback?: string;
soft_id?: number;
proxy?: string;
proxytype?: string;
userAgent?: string;
}
export interface yandexSmart {
pageurl: string;
sitekey: string;
pingback?: string;
proxy?: string;
proxytype?: string;
userAgent?: string;
}
export interface paramsGeeTestV4 {
pageurl: string;
captcha_id: string;
pingback?: string;
proxy?: string;
proxytype?: string;
userAgent?: string;
}
export interface paramsLemin {
pageurl: string;
captcha_id: string;
div_id: string;
api_server?: string;
pingback?: string;
proxy?: string;
proxytype?: string;
}
export interface paramsAmazonWAF {
pageurl: string;
sitekey: string;
iv: string;
context: string;
challenge_script?: string;
captcha_script?: string;
header_acao?: boolean;
pingback?: string;
soft_id?: number;
proxy?: string;
proxytype?: string;
}
export interface paramsTurnstile {
pageurl: string;
sitekey: string;
action?: string;
data?: string;
header_acao?: boolean;
pingback?: string;
soft_id?: number;
proxy?: string;
proxytype?: string;
}
export interface paramsCapyPuzzle {
pageurl: string;
captchakey: string;
api_server?: string;
version?: string;
pingback?: string;
proxy?: string;
proxytype?: string;
}
export interface paramsCoordinates {
body: string;
language?: 0 | 1 | 2;
lang?: string;
pingback?: string;
textinstructions?: string;
imginstructions?: string;
}
export interface paramsDataDome {
pageurl: string;
captcha_url: string;
userAgent: string;
pingback?: string;
proxy: string;
proxytype: string;
}
export interface paramsCyberSiARA {
pageurl: string;
master_url_id: string;
userAgent: string;
pingback?: string;
proxy?: string;
proxytype?: string;
}
export interface paramsMTCaptcha {
pageurl: string;
sitekey: string;
userAgent?: string;
pingback?: string;
proxy?: string;
proxytype?: string;
}
export interface paramsCutcaptcha {
pageurl: string;
miseryKey: string;
apiKey: string;
pingback?: string;
proxy?: string;
proxytype?: string;
}
export interface friendlyCaptcha {
pageurl: string;
sitekey: string;
pingback?: string;
proxy?: string;
proxytype?: string;
}
export interface paramsBoundingBox {
image: string;
textinstructions?: string;
imginstructions?: string;
}
export interface paramsGrid {
body: string;
recaptcha: number;
canvas?: number;
rows?: number;
cols?: number;
minClicks?: number;
maxClicks?: number;
previousId?: string;
imgType?: string;
textinstructions?: string;
imginstructions?: string;
canSkip?: number;
lang?: string;
pingback?: string;
}
export interface paramsTextcaptcha {
textcaptcha: string;
lang?: string;
pingback?: string;
}
export interface paramsRotateCaptcha {
body: string;
angle?: number;
pingback?: string;
lang?: string;
textinstructions?: string;
imginstructions?: string;
}
export interface paramsKeyCaptcha {
pageurl: string;
userId: string;
sessionId: string;
webServerSign: string;
webServerSign2: string;
pingback?: string;
proxy?: string;
proxytype?: string;
}
export interface paramsTencent {
pageurl: string;
appId: string;
pingback?: string;
proxy?: string;
proxytype?: string;
}
export interface paramsAtbCaptcha {
pageurl: string;
appId: string;
apiServer: string;
pingback?: string;
proxy?: string;
proxytype?: string;
}
export interface paramsAudioCaptcha {
body: string;
lang: string;
pingback?: string;
}
/**
* An object containing properties of the captcha solution.
* @typedef {Object} CaptchaAnswer
* @param {string} data The solution to the captcha
* @param {string} id The captcha ID
*/
interface CaptchaAnswer {
/** The solution to the captcha */
data: string;
/** The ID of the captcha solve */
id: string;
}
/**
* The main solvecaptcha class, housing all API calls and api interactions.
*
*/
export declare class Solver {
_apikey: string;
_pollingFrequency: number;
_headerACAO: number;
/**
* The constructor for the solvecaptcha Solver class.
*
* @param {string} apikey The API key to use
* @param {number} pollingFrequency The frequency to poll for requests
*
*/
constructor(apikey: string, pollingFrequency?: number, enableACAO?: boolean);
/** The API key this instance is using */
get apikey(): string;
/** Frequency the instance polls for updates */
get pollingFrequency(): number;
/** Set the API key for this instance */
set apikey(update: string);
private get in();
private get res();
private get defaultPayload();
/**
* Returns the remaining account balance.
*
* @return {Promise<Number>} Remaining balance
* @throws APIError
* @example
* solver.balance()
* .then((res) => {
* console.log(res)
* })
*/
balance(): Promise<number>;
/**
* @private
*
* Polls for a captcha, finding out if it's been completed
* @param {string} id Captcha ID
*
* @returns {Promise<CaptchaAnswer>}
* @throws APIError
*/
private pollResponse;
/**
* ### Solves a google reCAPTCHA V2 | V3.
*
* [Read more about other reCAPTCHA parameters](https://solvecaptcha.com/solvecaptcha-api#solving_recaptchav2_new).
*
* @param {{pageurl, googlekey, cookies, proxy, proxytype, userAgent, invisible, datas, pingback, action, enterprise, min_score, version, domain}} params Object
* @param {string} params.pageurl The URL the captcha appears on.
* @param {string} params.googlekey Value of `k` or `data-sitekey` parameter you found on page.
* @param {string} params.cookies Your cookies that will be passed to our worker who solve the captha.
* @param {string} params.proxy Format: `login:password@123.123.123.123:3128`. You can find more info about proxies [here](https://solvecaptcha.com/solvecaptcha-api#proxies).
* @param {string} params.proxytype Type of your proxy: `HTTP`, `HTTPS`, `SOCKS4`, `SOCKS5`.
* @param {string} params.userAgent Your `userAgent` that will be passed to our worker and used to solve the captcha.
* @param {number} params.invisible `1` - means that reCAPTCHA is invisible. `0` - normal reCAPTCHA.
* @param {string} params.datas Value of `data-s` parameter you found on page. Curenttly applicable for Google Search and other Google services.
* @param {string} params.pingback URL for pingback (callback) response that will be sent when captcha is solved. URL should be registered on the server. [More info here](https://solvecaptcha.com/solvecaptcha-api#pingback).
* @param {string} params.action Value of `action` parameter you found on page.
* @param {number} params.enterprise `1` - defines that you're sending reCAPTCHA Enterpise.
* @param {number} params.min_score The score needed for resolution reCAPTCHA V3. Currently it's almost impossible to get token with score higher than `0.3`
* @param {string} params.version `v2` — defines that you're sending a reCAPTCHA V2. `v3` — defines that you're sending a reCAPTCHA V3.
* @param {string} params.domain Domain used to load the captcha: `google.com` or `recaptcha.net`
*
* @returns {Promise<CaptchaAnswer>} The result from the solve.
* @throws APIError
* @example
* solver.recaptcha({
* pageurl: 'https://solvecaptcha.com/demo/recaptcha-v2',
* googlekey: '6LfD3PIbAAAAAJs_eEHvoOl75_83eXSqpPSRFJ_u'
* })
* .then((res) => {
* console.log(res);
* })
* .catch((err) => {
* console.log(err);
* })
*/
recaptcha(params: paramsRecaptcha): Promise<CaptchaAnswer>;
/**
* ### Solves a hCaptcha
*
* [Read more about other hCaptcha parameters](https://solvecaptcha.com/solvecaptcha-api#solving_hcaptcha).
*
* @param {{sitekey, pageurl, data, userAgent, invisible, pingback, proxy, proxytype, domain}} params Object
* @param {string} params.sitekey The hcaptcha site key. Value of `k` or `data-sitekey` parameter you found on page.
* @param {string} params.pageurl The URL the captcha appears on.
* @param {string} params.data Custom `data` that is used in some implementations of hCaptcha, mostly with `invisible=1`. In most cases you see it as `rqdata` inside network requests. IMPORTANT: you MUST provide `userAgent` if you submit captcha with `data` paramater. The value should match the User-Agent you use when interacting with the target website.
* @param {string} params.userAgent Your userAgent that will be passed to our worker and used to solve the captcha. Required for hCaptcha with `data` parameter.
* @param {number} params.invisible Use `1` for invisible version of hcaptcha. Currently it is a very rare case.
* @param {string} params.pingback URL for pingback (callback) response that will be sent when captcha is solved. URL should be registered on the server. More info [here](https://solvecaptcha.com/solvecaptcha-api#pingback).
* @param {string} params.proxy Format: `login:password@123.123.123.123:3128` You can find more info about proxies [here](https://solvecaptcha.com/solvecaptcha-api#proxies).
* @param {string} params.proxytype Type of your proxy: `HTTP`, `HTTPS`, `SOCKS4`, `SOCKS5`.
* @param {string} params.domain Domain used to load the captcha: `hcaptcha.com` or `js.hcaptcha.com`
*
* @returns {Promise<CaptchaAnswer>} The result from the solve
* @throws APIError
* @example
* solver.hcaptcha({
* pageurl: "https://solvecaptcha.com/demo/hcaptcha",
* sitekey: "b76cd927-d266-4cfb-a328-3b03ae07ded6"
* .then((res) => {
* console.log(res);
* })
* .catch((err) => {
* console.log(err);
* })
*/
hcaptcha(params: paramsHCaptcha): Promise<CaptchaAnswer>;
/**
* ### Solves a GeeTest Captcha.
*
* [Read more about parameters and solving for Geetest captcha](https://solvecaptcha.com/solvecaptcha-api#solving_geetest).
*
* @param {{ gt, challenge, api_server, offline, new_captcha,
* pageurl, pingback, proxy, proxytype, userAgent }} params
* @param {string} params.gt Value of gt parameter found on site
* @param {string} params.challenge Value of challenge parameter found on site
* @param {string} params.pageurl The URL the captcha appears on
* @param {string} params.api_server The URL of the api_server (recommended)
* @param {number} params.offline In rare cases `initGeetest` can be called with `offline` parameter on the target page. If the call uses offline: true, set the value to `1`.
* @param {number} params.new_captcha In rare cases `initGeetest` can be called with `new_captcha` parameter. If the call uses `new_captcha: true`, set the value to `1`. Mostly used with offline parameter.
* @param {string} params.pingback URL for `pingback` (callback) response that will be sent when captcha is solved. [More info here](https://solvecaptcha.com/solvecaptcha-api#pingback).
* @param {string} params.proxy Format: `login:password@123.123.123.123:3128`. You can find more info about proxies [here](https://solvecaptcha.com/solvecaptcha-api#proxies).
* @param {string} params.proxytype Type of your proxy: `HTTP`, `HTTPS`, `SOCKS4`, `SOCKS5`.
* @param {string} params.userAgent Your `userAgent` that will be passed to our worker and used to solve the captcha.
*
* @returns {Promise<CaptchaAnswer>} The result from the solve.
* @throws APIError
* @example
* ;(async () => {
*
* // Warning: Attention, the `challenge` value is not static but dynamic.
* // You need to find the queries that makes the captcha on the page to API.
* // Then you need to make request to this API and get new `challenge`.
*
* // For page https://solvecaptcha.com/demo/geetest, api address is https://solvecaptcha.com/api/v1/captcha-demo/gee-test/init-params?t=${t}
* // Also note that when make request to API, the request uses the dynamic parameter `t`
*
* // You can read more about sending GeeTest here https://solvecaptcha.com/solvecaptcha-api#solving_geetest, or here https://solvecaptcha.com/p/geetest
* // In this example I solve GeeTest from page https://solvecaptcha.com/demo/geetest
*
* const t = new Date().getTime()
* // below i make a request to get a new `challenge`.
* const response = await fetch(`https://solvecaptcha.com/api/v1/captcha-demo/gee-test/init-params?t=${t}`)
* const data = await response.json()
*
* const params = {
* pageurl: 'https://solvecaptcha.com/demo/geetest',
* gt: data.gt,
* challenge: data.challenge
* }
*
* const res = await solver.geetest(params)
* try {
* console.log(res)
* } catch (error) {
* console.error(error);
* }
* })()
*/
geetest(params: paramsGeetest): Promise<CaptchaAnswer>;
/**
* ### Solves a GeeTest V4 Captcha.
*
* This method accepts an object with the following fields: `pageurl`, `captcha_id`, `pingback`, `proxy`, `proxytype`, `userAgent`.
* The `pageurl` and `captcha_id` fields are required.
*
* @param {{pageurl, captcha_id, pingback, proxy, proxytype, userAgent}} params The method geetestV4 takes arguments as an object.
* @param {string} params.pageurl Full URL of the page where you see Geetest V4 captcha.
* @param {string} params.captcha_id Required parameter. Value of `captcha_id` parameter you found on target website.
* @param {string} params.pingback An optional param. [More info here](https://solvecaptcha.com/solvecaptcha-api#pingback).
* @param {string} params.proxy An optional param. Format: `login:password@123.123.123.123:3128`. You can find more info about proxies [here](https://solvecaptcha.com/solvecaptcha-api#proxies).
* @param {string} params.proxytype An optional param. Type of your proxy: `HTTP`, `HTTPS`, `SOCKS4`, `SOCKS5`.
* @param {string} params.userAgent An optional param. Your `userAgent` that will be passed to our worker and used to solve the captcha.
*
* @returns {Promise<CaptchaAnswer>} The result from the solve.
* @throws APIError
* @example
* solver.geetestV4({
* pageurl: 'https://solvecaptcha.com/demo/geetest-v4',
* captcha_id: 'e392e1d7fd421dc63325744d5a2b9c73'
* })
* .then((res) => {
* console.log(res)
* })
* .catch((err) => {
* console.log(err);
* })
*/
geetestV4(params: paramsGeeTestV4): Promise<CaptchaAnswer>;
/**
* ### Method for sending Yandex Smart Captcha.
*
* This method accepts an object with the following fields: `pageurl`, `sitekey`, `pingback`, `proxy`, `proxytype`.
* The `pageurl` and `sitekey` fields are required.
*
* @param {{pageurl, sitekey, pingback, proxy, proxytype, userAgent}} params The method takes arguments as an object.
* @param {string} params.pageurl Required parameter. URL of the page where the captcha is located.
* @param {string} params.sitekey Required parameter. The `sitekey` value you found on the captcha page.
* @param {string} params.pingback An optional param.
* @param {string} params.proxy An optional param. Format: `login:password@123.123.123.123:3128`.
* @param {string} params.proxytype An optional param. Type of your proxy: `HTTP`, `HTTPS`, `SOCKS4`, `SOCKS5`.
* @param {string} params.userAgent An optional param. Your `userAgent` that will be passed to our worker and used to solve the captcha.
*
* @returns {Promise<CaptchaAnswer>} The result from the solve.
* @throws APIError
* @example
* solver.yandexSmart({
* pageurl: "https://captcha-api.yandex.ru/demo",
* sitekey: "FEXfAbHQsToo97VidNVk3j4dC74nGW1DgdxjtNB9"
* })
* .then((res) => {
* console.log(res)
* })
* .catch((err) => {
* console.log(err);
* })
*/
yandexSmart(params: yandexSmart): Promise<CaptchaAnswer>;
/**
* ### Solves a image-based captcha.
*
* [Read more about parameters for image captcha](https://solvecaptcha.com/solvecaptcha-api#solving_normal_captcha).
*
* @param {{ body,
* phrase,
* regsense,
* numeric,
* calc,
* min_len,
* max_len,
* language,
* lang,
* textinstructions,
* pingback }} params Extra properties to pass to solvecaptcha.
* @param {string} params.body Base64 image data for the captcha.
* @param {number} params.phrase Captcha contains two or more words? `1` - Yes. `0` - No.
* @param {number} params.regsense Captcha is case sensitive? `1` - Yes. `0` - No.
* @param {number} params.numeric `0` - not specified. `1` - captcha contains only numbers. `2` - captcha contains only letters. `3` - captcha contains only numbers OR only letters. `4` - captcha MUST contain both numbers AND letters.
* @param {number} params.calc Does captcha require calculations? (e.g. type the result 4 + 8 = ) `1` - Yes. `0` - No.
* @param {number} params.min_len `1..20` - minimal number of symbols in captcha. `0` - not specified.
* @param {number} params.max_len `1..20` - maximal number of symbols in captcha. `0` - not specified.
* @param {number} params.language `0` - not specified. `1` - Cyrillic captcha. `2` - Latin captcha
* @param {string} params.lang Language code. [See the list of supported languages](https://solvecaptcha.com/solvecaptcha-api#language).
* @param {string} params.textinstructions Text will be shown to worker to help him to solve the captcha correctly. For example: type red symbols only.
* @param {string} params.pingback URL for `pingback` (callback) response that will be sent when captcha is solved. [More info here](https://solvecaptcha.com/solvecaptcha-api#pingback).
*
* @returns {Promise<CaptchaAnswer>} The result from the solve
* @throws APIError
* @example
* const imageBase64 = fs.readFileSync("./tests/media/imageCaptcha_6e584.png", "base64")
*
* solver.imageCaptcha({
* body: imageBase64,
* numeric: 4,
* min_len: 5,
* max_len: 5
* })
* .then((res) => {
* console.log(res);
* })
* .catch((err) => {
* console.log(err);
* })
*/
imageCaptcha(params: paramsImageCaptcha): Promise<CaptchaAnswer>;
/**
* ### Solves Arkose Labs FunCaptcha.
*
* [Read more](https://solvecaptcha.com/solvecaptcha-api#solving_funcaptcha_new) about other solving and other parameters for Arkose Labs FunCaptcha.
*
* @param {{pageurl, publicKey, surl, data, pingback, proxy, proxytype, userAgent}} params Object
* @param {string} params.publicKey The FunCaptcha Public Key
* @param {string} params.pageurl The URL to the website the captcha is seen on
* @param {string} params.surl The FunCaptcha Service URL (recommended)
* @param {string} params.data Custom data to pass to FunCaptcha. For example: `'data': '{"blob": "foo"}'`.
* @param {string} params.pingback URL for pingback (callback) response that will be sent when captcha is solved. URL should be registered on the server. [More info here](https://solvecaptcha.com/solvecaptcha-api#pingback).
* @param {string} params.proxy Format: `login:password@123.123.123.123:3128` You can find more info about proxies [here](https://solvecaptcha.com/solvecaptcha-api#proxies).
* @param {string} params.proxytype Type of your proxy: `HTTP`, `HTTPS`, `SOCKS4`, `SOCKS5`.
* @param {string} params.userAgent Your `userAgent` that will be passed to our worker and used to solve the captcha.
*
* @returns {Promise<CaptchaAnswer>} The result from the solve
* @throws APIError
*
* @example
* 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(params: paramsFunCaptcha): Promise<CaptchaAnswer>;
/**
*
* ### Solves a Lemin captcha
*
* [Read more about other Lemin captcha parameters](https://solvecaptcha.com/solvecaptcha-api#lemin).
*
* @param {{ pageurl, captcha_id, div_id, api_server, pingback, proxy, proxytype}} params Object
* @param {string} params.pageurl The URL the captcha appears on.
* @param {string} params.captcha_id Value of `captcha_id` parameter you found on page.
* @param {string} params.div_id Value `id` of captcha pareent `<div></div>` element.
* @param {string} params.api_server The domain part of script URL you found on page. Default value: `https://api.leminnow.com/`
* @param {string} params.pingback URL for pingback (callback) response that will be sent when captcha is solved. URL should be registered on the server. [More info here](https://solvecaptcha.com/solvecaptcha-api#pingback).
* @param {string} params.proxy Format: `login:password@123.123.123.123:3128` You can find more info about proxies [here](https://solvecaptcha.com/solvecaptcha-api#proxies).
* @param {string} params.proxytype Type of your proxy: `HTTP`, `HTTPS`, `SOCKS4`, `SOCKS5`.
*
* @example
* 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);
* })
*/
lemin(params: paramsLemin): Promise<CaptchaAnswer>;
/**
*
* ### Solves Amazon WAF captcha
*
* [Read more about "Amazon WAF" captcha](https://solvecaptcha.com/solvecaptcha-api#amazon-waf).
*
* @param {{ pageurl, sitekey, iv, context, challenge_script, captcha_script, pingback, proxy, proxytype}} params The `amazonWaf` method takes arguments as an object. Thus, the `pageurl`, `sitekey`, `iv`, `context` fields in the passed object are mandatory.
* @param {string} params.pageurl Is the full `URL` of page where you were challenged by the captcha.
* @param {string} params.sitekey Is a value of `key` parameter in the page source.
* @param {string} params.iv Is a value of `iv` parameter in the page source.
* @param {string} params.context Is a value of `context` parameter in the page source.
* @param {string} params.challenge_script The source URL of `challenge.js` script on the page.
* @param {string} params.captcha_script The source URL of `captcha.js` script on the page.
* @param {string} params.pingback URL for pingback (callback) response that will be sent when captcha is solved. URL should be registered on the server. [More info here](https://solvecaptcha.com/solvecaptcha-api#pingback).
* @param {string} params.proxy Format: `login:password@123.123.123.123:3128` You can find more info about proxies [here](https://solvecaptcha.com/solvecaptcha-api#proxies).
* @param {string} params.proxytype Type of your proxy: `HTTP`, `HTTPS`, `SOCKS4`, `SOCKS5`.
*
* @example
* solver.amazonWaf({
* pageurl: "https://non-existent-example.execute-api.us-east-1.amazonaws.com/latest",
* sitekey: "AQIDAHjcYu/GjX+QlghicBgQ/7bFaQZ+m5FKCMDnO+vTbNg96AHMDLodoefdvyOnsHMRtEKQAAAAfjB8BgkqhkiG9w0BBwagbzBtAgEAMGgGCSqGSIb3DQEHATAeBglghkgBZQMEAS4wEQQMUX+ZqwwuANRnZujSAgEQgDvHSxUQmVBuyUtumoW2n4ccTG7xQN1r3X/zz41qmQaYv9SSSvQrjIoDXKaUQ23tVb4ii8+uljuRdz/HPA==",
* context: "9BUgmlm48F92WUoqv97a49ZuEJJ50TCk9MVr3C7WMtQ0X6flVbufM4n8mjFLmbLVAPgaQ1Jydeaja94iAS49ljb+sUNLoukWedAQZKrlY4RdbOOzvcFqmD/ZepQFS9N5w15Exr4VwnVq+HIxTsDJwRviElWCdzKDebN/mk8/eX2n7qJi5G3Riq0tdQw9+C4diFZU5E97RSeahejOAAJTDqduqW6uLw9NsjJBkDRBlRjxjn5CaMMo5pYOxYbGrM8Un1JH5DMOLeXbq1xWbC17YSEoM1cRFfTgOoc+VpCe36Ai9Kc=",
* iv: "CgAHbCe2GgAAAAAj",
* })
* .then((res) => {
* console.log(res);
* })
* .catch((err) => {
* console.log(err);
* })
*/
amazonWaf(params: paramsAmazonWAF): Promise<CaptchaAnswer>;
/**
*
* ### Solves Cloudflare Turnstile captcha
*
* [Read more about Cloudflare Turnstile captcha](https://solvecaptcha.com/solvecaptcha-api#turnstile).
*
* @param {{ pageurl, sitekey, action, data, pingback, proxy, proxytype}} params The `cloudflareTurnstile` method takes arguments as an object. Thus, the `pageurl`, `sitekey` fields in the passed object are mandatory.
* @param {string} params.pageurl Full `URL` of the page where you see the captcha.
* @param {string} params.sitekey Is a value of `sitekey` parameter in the page source.
* @param {string} params.action Value of optional `action` parameter you found on page.
* @param {string} params.data Value of optional `data` parameter you found on page.
* @param {string} params.pingback URL for pingback (callback) response that will be sent when captcha is solved. URL should be registered on the server. [More info here](https://solvecaptcha.com/solvecaptcha-api#pingback).
* @param {string} params.proxy Format: `login:password@123.123.123.123:3128` You can find more info about proxies [here](https://solvecaptcha.com/solvecaptcha-api#proxies).
* @param {string} params.proxytype Type of your proxy: `HTTP`, `HTTPS`, `SOCKS4`, `SOCKS5`.
*
* @example
* solver.cloudflareTurnstile({
* pageurl: "https://app.nodecraft.com/login",
* sitekey: "0x4AAAAAAAAkg0s3VIOD10y4"
* })
* .then((res) => {
* console.log(res);
* })
* .catch((err) => {
* console.log(err);
* })
*/
cloudflareTurnstile(params: paramsTurnstile): Promise<CaptchaAnswer>;
/**
* ### Solves a Coordinates captcha.
*
* @param {{ body, imginstructions, textinstructions, language, lang, pingback }} params parameters Coordinates Captcha as an object.
* @param {string} params.body Base64-encoded captcha image.
* @param {string} params.imginstructions Base64-encoded image with instruction for solving captcha.
* @param {string} params.textinstructions Text will be shown to worker to help him to solve the captcha correctly. For example: click on all objects in red color.
* @param {number} params.language `0` - not specified. `1` - Cyrillic captcha. `2` - Latin captcha
* @param {string} params.lang Language code. [See the list of supported languages](https://solvecaptcha.com/solvecaptcha-api#language).
* @param {string} params.pingback URL for `pingback` (callback) response that will be sent when captcha is solved. [More info here](https://solvecaptcha.com/solvecaptcha-api#pingback).
*
* @returns {Promise<CaptchaAnswer>} The result from the solve
*
* @example
* const imageBase64 = fs.readFileSync("./tests/media/hCaptchaImage.jpg", "base64")
*
* solver.coordinates({
* body: imageBase64,
* textinstructions: 'Select all photos containing the boat'
* })
* .then((res) => {
* console.log(res);
* })
* .catch((err) => {
* console.log(err);
* })
*/
coordinates(params: paramsCoordinates): Promise<CaptchaAnswer>;
/**
* ### Solves Capy Puzzle captcha
*
* @param {{ pageurl, captchakey, api_server, version, pingback, proxy, proxytype}} params Parameters Capy Puzzle Captcha as an object.
* @param {string} params.pageurl Full `URL`of the page where you see the captcha.
* @param {string} params.captchakey Value of `captchakey` parameter you found on page.
* @param {string} params.api_server The domain part of script URL you found on page. Default value: `https://jp.api.capy.me/`.
* @param {string} params.version The version of captcha task: `puzzle` (assemble a puzzle) or `avatar` (drag an object)..
* @param {string} params.pingback URL for pingback (callback) response that will be sent when captcha is solved. URL should be registered on the server. [More info here](https://solvecaptcha.com/solvecaptcha-api#pingback).
* @param {string} params.proxy Format: `login:password@123.123.123.123:3128` You can find more info about proxies [here](https://solvecaptcha.com/solvecaptcha-api#proxies).
* @param {string} params.proxytype Type of your proxy: `HTTP`, `HTTPS`, `SOCKS4`, `SOCKS5`.
*
* @example
* solver.capyPuzzle({
* pageurl: "https://www.capy.me/account/register/",
* captchakey: "PUZZLE_Cme4hZLjuZRMYC3uh14C52D3uNms5w"
* })
* .then((res) => {
* console.log(res);
* })
* .catch((err) => {
* console.log(err);
* })
*/
capyPuzzle(params: paramsCapyPuzzle): Promise<CaptchaAnswer>;
/**
* ### Solves DataDome captcha
*
* @param {{ pageurl, captcha_url, userAgent, pingback, proxy, proxytype}} params Parameters DataDome Captcha as an object.
* @param {string} params.pageurl Full `URL` of the page where you see the captcha.
* @param {string} params.captcha_url The value of the `src` parameter for the `iframe` element containing the captcha on the page.
* @param {string} params.userAgent ser-Agent of your MODERN browser
* @param {string} params.pingback URL for pingback (callback) response that will be sent when captcha is solved. URL should be registered on the server. [More info here](https://solvecaptcha.com/solvecaptcha-api#pingback).
* @param {string} params.proxy Format: `login:password@123.123.123.123:3128` You can find more info about proxies [here](https://solvecaptcha.com/solvecaptcha-api#proxies).
* @param {string} params.proxytype Type of your proxy: `HTTP`, `HTTPS`, `SOCKS4`, `SOCKS5`.
*
* @example
* 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: "1.2.3.4:8888:user:password",
* proxytype: "http"
* })
* .then((res) => {
* console.log(res);
* })
* .catch((err) => {
* console.log(err);
* })
*/
dataDome(params: paramsDataDome): Promise<CaptchaAnswer>;
/**
* ### Solves CyberSiARA captcha
*
* @param {{ pageurl, master_url_id, userAgent, pingback, proxy, proxytype}} params Parameters CyberSiARA Captcha as an object.
* @param {string} params.pageurl Full `URL` of the page where you see the captcha.
* @param {string} params.master_url_id The value of `MasterUrlId` parameter obtained from the request to the endpoint `API/CyberSiara/GetCyberSiara`.
* @param {string} params.userAgent ser-Agent of your MODERN browser
* @param {string} params.pingback URL for pingback (callback) response that will be sent when captcha is solved. URL should be registered on the server. [More info here](https://solvecaptcha.com/solvecaptcha-api#pingback).
* @param {string} params.proxy Format: `login:password@123.123.123.123:3128` You can find more info about proxies [here](https://solvecaptcha.com/solvecaptcha-api#proxies).
* @param {string} params.proxytype Type of your proxy: `HTTP`, `HTTPS`, `SOCKS4`, `SOCKS5`.
*
* @example
* 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);
* })
*/
cyberSiARA(params: paramsCyberSiARA): Promise<CaptchaAnswer>;
/**
* ### Solves MTCaptcha
*
* @param {{ pageurl, sitekey, userAgent, pingback, proxy, proxytype}} params Parameters MTCaptcha as an object.
* @param {string} params.pageurl Full `URL` of the page where you see the captcha.
* @param {string} params.sitekey TThe value of `sitekey` parameter found on the page.
* @param {string} params.pingback URL for pingback (callback) response that will be sent when captcha is solved. URL should be registered on the server. [More info here](https://solvecaptcha.com/solvecaptcha-api#pingback).
* @param {string} params.proxy Format: `login:password@123.123.123.123:3128` You can find more info about proxies [here](https://solvecaptcha.com/solvecaptcha-api#proxies).
* @param {string} params.proxytype Type of your proxy: `HTTP`, `HTTPS`, `SOCKS4`, `SOCKS5`.
*
* @example
* solver.mtCaptcha({
* pageurl: "https://service.mtcaptcha.com/mtcv1/demo/index.html",
* sitekey: "MTPublic-DemoKey9M"
* })
* .then((res) => {
* console.log(res);
* })
* .catch((err) => {
* console.log(err);
* })
*/
mtCaptcha(params: paramsMTCaptcha): Promise<CaptchaAnswer>;
/**
* ### Solves a Cutcaptcha.
*
* Use this method to solve Cutcaptcha. Returns the response in JSON.
* [Read more about Cutcaptcha Method](https://solvecaptcha.com/solvecaptcha-api#cutcaptcha).
*
* @param {{ pageurl, miseryKey, apiKey, pingback, proxy, proxytype }} params Parameters for solving Cutcaptcha as an object.
* @param {string} params.pageurl The URL where the captcha is located.
* @param {string} params.miseryKey The value of `CUTCAPTCHA_MISERY_KEY` variable defined on page.
* @param {string} params.apiKey The value of `data-apikey` attribute of iframe's body. Also the name of javascript file included on the page
* @param {string} [params.pingback] Optional param. URL for pingback (callback) response when captcha is solved.
* @param {string} [params.proxy] Optional param. Proxy to use while solving the captcha. Format: `login:password@123.123.123.123:3128`.
* @param {string} [params.proxytype] Optional param. Type of your proxy: `HTTP`, `HTTPS`, `SOCKS4`, `SOCKS5`.
*
* @returns {Promise<CaptchaAnswer>} The result from the solve.
* @throws APIError
*
* @example
* solver.cutCaptcha({
* pageurl: "https://mysite.com/page/with/cutcaptcha",
* miseryKey: "098e6a849af406142e3150dbf4e6d0538db2b51f",
* apiKey: "SAs61IAI",
* })
* .then((res) => {
* console.log(res);
* })
* .catch((err) => {
* console.log(err);
* })
*/
cutCaptcha(params: paramsCutcaptcha): Promise<CaptchaAnswer>;
/**
* ### Solves Friendly Captcha
*
* @param {{ pageurl, sitekey, pingback, proxy, proxytype}} params Parameters Friendly Captcha as an object.
* @param {string} params.pageurl Full `URL` of the page where you see the captcha.
* @param {string} params.sitekey The value of `data-apikey` or `data-sitekey` parameter found on the page.
* @param {string} params.pingback URL for pingback (callback) response that will be sent when captcha is solved. URL should be registered on the server. [More info here](https://solvecaptcha.com/solvecaptcha-api#pingback).
* @param {string} params.proxy Format: `login:password@123.123.123.123:3128` You can find more info about proxies [here](https://solvecaptcha.com/solvecaptcha-api#proxies).
* @param {string} params.proxytype Type of your proxy: `HTTP`, `HTTPS`, `SOCKS4`, `SOCKS5`.
*
* @example
* solver.friendlyCaptcha({
* pageurl: "https://geizhals.de/?liftban=1&from=/455973138?fsean=5901747021356",
* sitekey: "FCMST5VUMCBOCGQ9"
* })
* .then((res) => {
* console.log(res);
* })
* .catch((err) => {
* console.log(err);
* })
*/
friendlyCaptcha(params: friendlyCaptcha): Promise<CaptchaAnswer>;
/**
* ### Bounding Box Method
*
* @param {{ image, textinstructions, imginstructions }} params Parameters Bounding Box Method as an object.
* @param {string} params.image Image containing data for markup. The image must be encoded in `Base64` format.
* @param {string} params.textinstructions Text will be shown to worker to help him to select object on the image correctly. For example: "*Select cars in the image*". **Optional parameter**, if the instruction already exists in the form of the `imginstructions`.
* @param {string} params.imginstructions Image with instruction for worker to help him to select object on the image correctly. The image must be encoded in `Base64` format. **Optional parameter**, if the instruction already exists in the form of the `textinstructions`.
*
* @example
* solver.boundingBox({
* image: "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgG...",
* textinstructions: "Select cars in the image"
* })
* .then((res) => {
* console.log(res);
* })
* .catch((err) => {
* console.log(err);
* })
*/
boundingBox(params: paramsBoundingBox): Promise<CaptchaAnswer>;
/**
* ### Grid method
*
* The method can be used to bypass tasks where a grid is applied to an image and you need to click on grid tiles, like reCAPTCHA or hCaptcha images.
*
* @param {{ body, textinstructions, imginstructions, rows, cols, minClicks, maxClicks, imgType, previousId, canSkip, lang, pingback}} params Parameters Grid Method as an object.
* @param {string} params.body `Base64`- encoded captcha image.
* @param {string} params.textinstructions Text will be shown to worker to help him to select object on the image correctly. For example: "*Select cars in the image*". **Optional parameter**, if the instruction already exists in the form of the `imginstructions`.
* @param {string} params.imginstructions Image with instruction for worker to help him to select object on the image correctly. The image must be encoded in `Base64` format. **Optional parameter**, if the instruction already exists in the form of the `textinstructions`.
* @param {number} params.rows Number of rows in grid captcha.
* @param {number} params.cols Number of columns in grid captcdha.
* @param {number} params.minClicks The minimum number of tiles that must be selected. Can't be more than `rows` * `cols`.
* @param {number} params.maxClicks The maximum number of tiles that can be selected on the image.
* @param {string} params.imgType The image will be recognized using Computer Vision. Supported value options: `recaptcha`, `hcaptcha`, `funcaptcha`, `funcaptcha_compare`. [More info here](https://solvecaptcha.com/solvecaptcha-api#grid).
* @param {string} params.previousId Id of your previous request with the same captcha challenge.
* @param {number} params.canSkip Set the value to `1` only if it's possible that there's no images matching to the instruction. We'll provide a button "No matching images" to worker and you will receive `No_matching_images` as answer.
* @param {string} params.lang Language code. [See the list of supported languages](https://solvecaptcha.com/solvecaptcha-api#language).
* @param {string} params.pingback params.pingback URL for pingback (callback) response that will be sent when captcha is solved. URL should be registered on the server. [More info here](https://solvecaptcha.com/solvecaptcha-api#pingback).
*
* @example
* solver.grid({
* body: 'iVBORw0KGgoAAAANSUhEUgAAAcIA...',
* textinstructions: "Select cars in the image",
* imginstructions: '/9j/4AAQSkZJRgABAQEA...'
* })
* .then((res) => {
* console.log(res);
* })
* .catch((err) => {
* console.log(err);
* })
*/
grid(params: paramsGrid): Promise<CaptchaAnswer>;
/**
* ### Text Captcha method
*
* Text Captcha is a type of captcha that is represented as text and doesn't contain images. Usually you have to answer a question to pass the verification. For example: "If tomorrow is Saturday, what day is today?".
* [Read more about Text Captcha Method](https://solvecaptcha.com/solvecaptcha-api#text-captcha).
*
* @param {{ textcaptcha, lang, pingback}} params Parameters Text Captcha Method as an object.
* @param {string} params.textcaptcha Text Captcha is a type of captcha that is represented as text and doesn't contain images. Usually you have to answer a question to pass the verification.
* @param {string} params.lang Language code. [See the list of supported languages](https://solvecaptcha.com/solvecaptcha-api#language).
* @param {string} params.pingback params.pingback URL for pingback (callback) response that will be sent when captcha is solved. URL should be registered on the server. [More info here](https://solvecaptcha.com/solvecaptcha-api#pingback).
*
* @example
* solver.text({
* textcaptcha: "If tomorrow is Saturday, what day is today?",
* lang: 'en'
* })
* .then((res) => {
* console.log(res);
* })
* .catch((err) => {
* console.log(err);
* })
*/
text(params: paramsTextcaptcha): Promise<CaptchaAnswer>;
/**
* ### Canvas method
*
* This method can be used to bypass tasks in which you need to circle an object or line in an image.
* [Read more about Canvas Method](https://solvecaptcha.com/solvecaptcha-api#canvas).
*
* @param {{ body, textinstructions, imginstructions, canSkip, lang, pingback}} params Parameters Canvas as an object.
* @param {string} params.body `Base64`- encoded captcha image.
* @param {string} params.textinstructions Text will be shown to worker to help him to select object on the image correctly. For example: "*Select cars in the image*". **Optional parameter**, if the instruction already exists in the form of the `imginstructions`.
* @param {string} params.imginstructions Image with instruction for worker to help him to select object on the image correctly. The image must be encoded in `Base64` format. **Optional parameter**, if the instruction already exists in the form of the `textinstructions`.
* @param {number} params.canSkip Set the value to `1` only if it's possible that there's no images matching to the instruction. We'll provide a button "No matching images" to worker and you will receive `No_matching_images` as answer.
* @param {string} params.lang Language code. [See the list of supported languages](https://solvecaptcha.com/solvecaptcha-api#language).
* @param {string} params.pingback params.pingback URL for pingback (callback) response that will be sent when captcha is solved. URL should be registered on the server. [More info here](https://solvecaptcha.com/solvecaptcha-api#pingback).
*
* @example
* solver.canvas({
* body: 'iVBORw0KGgoAAAANSgAAAcIA...',
* imginstructions: '/9j/4AAQSkZJRgABAQEA...',
* textinstructions: 'Highlight the red CIRCLE'
* })
* .then((res) => {
* console.log(res);
* })
* .catch((err) => {
* console.log(err);
* })
*/
canvas(params: paramsGrid): Promise<CaptchaAnswer>;
/**
* ### Rotate method
*
* This method can be used to solve a captcha that asks to rotate an object. It is mostly used to bypass FunCaptcha. Returns the rotation angle.
* [Read more about Rotate Method](https://solvecaptcha.com/solvecaptcha-api#solving_rotatecaptcha).
*
* @param {{ body, angle, pingback, lang, textinstructions, imginstructions }} params Parameters for solving Rotate Captcha as an object.
* @param {string} params.body Base64-encoded image of the captcha that needs to be rotated.
* @param {number} params.angle Angle to which the captcha needs to be rotated to solve it correctly. Value between `0` to `360`.
* @param {string} params.textinstructions Optional param. Text instruction that will be shown to worker to help solve the captcha correctly.
* @param {string} params.imginstructions Optional param. Base64-encoded image instruction that will be shown to worker to help solve the captcha correctly.
* @param {string} params.lang Optional param. Language code for worker to use while solving the captcha.
* @param {string} params.pingback Optional param. URL for pingback (callback) response when captcha is solved.
*
* @returns {Promise<CaptchaAnswer>} The result from the solve.
* @throws APIError
*
* @example
* solver.rotate({
* body: "iVBORw0KGgoAAAANSUhEUgAAAcIA...",
* angle: 15,
* textinstructions: "Rotate the object to the correct position"
* })
* .then((res) => {
* console.log(res);
* })
* .catch((err) => {
* console.log(err);
* })
*/
rotate(params: paramsRotateCaptcha): Promise<CaptchaAnswer>;
/**
* ### Solves a KeyCaptcha.
*
* This method can be used to solve a KeyCaptcha. It is mostly used to bypass captchas that use KeyCaptcha technology.
* [Read more about KeyCaptcha Method](https://solvecaptcha.com/solvecaptcha-api#solving_keycaptcha).
*
* @param {{ pageurl, userId, sessionId, webServerSign, webServerSign2, pingback, proxy, proxytype }} params Parameters for solving KeyCaptcha as an object.
* @param {string} params.pageurl The URL where the captcha is located.
* @param {string} params.userId Value of `s_s_c_user_id` parameter you found on page.
* @param {string} params.sessionId Value of `s_s_c_session_id` parameter you found on page.
* @param {string} params.webServerSign Value of `s_s_c_web_server_sign` parameter you found on page.
* @param {string} params.webServerSign2 Value of `s_s_c_web_server_sign2` parameter you found on page.
* @param {string} [params.pingback] Optional param. URL for pingback (callback) response when captcha is solved.
* @param {string} [params.proxy] Optional param. Proxy to use while solving the captcha. Format: `login:password@123.123.123.123:3128`.
* @param {string} [params.proxytype] Optional param. Type of your proxy: `HTTP`, `HTTPS`, `SOCKS4`, `SOCKS5`.
*
* @returns {Promise<CaptchaAnswer>} The result from the solve.
* @throws APIError
*
* @example
* solver.keyCaptcha({
* pageurl: "https://solvecaptcha.com/demo/keycaptcha",
* userId: "184015",
* sessionId: "11975dc265ce9174a54edb1619af15b7",
* webServerSign: "73ef77fd3cf0ce02947d9088bdc8412a",
* webServerSign2: "93836d9e7007f38f072ce07d89bb7e2b"
* })
* .then((res) => {
* console.log(res);
* })
* .catch((err) => {
* console.log(err);
* })
*/
keyCaptcha(params: paramsKeyCaptcha): Promise<CaptchaAnswer>;
/**
* ### Solves a Tencent.
*
* Use this method to solve Tencent captcha. Returns a token.
* [Read more about Tencent Method](https://solvecaptcha.com/solvecaptcha-api#tencent).
*
* @param {{ pageurl, appId, pingback, proxy, proxytype }} params Parameters for solving Tencent as an object.
* @param {string} params.pageurl The URL where the captcha is located.
* @param {string} params.appId The value of `appId` parameter in the website source code.
* @param {string} [params.pingback] Optional param. U