Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Parameter

Type

Required

Description

clientKey

string

yes

Your client key

type

string

yes

CloudFlare5STask

websiteURL

string

yes

website url, usually a fixed value.

proxy

string

yes

The proxy you used to access the website

rqData

Object

optional

if you add this parameter, it will be sent as post request, like:

rqData: { "mode": "JSON" ...}

Request Example

Code Block
POST https://api.ez-captcha.com/createTask

Content-Type: application/json

{
    "clientKey": "cc9c18d3e263515c2c072b36a7125eecc078618fYourClientKey",
    "task": {
        "websiteURL": "https://xxx.com",
        "type": "CloudFlare5STask",
        "proxy": "http://username:password@ip:port",
        "rqData":{                   //optional
            "mode":"JSON",//JSON or FORM is determined based on the submission method of the webpage. If you need to send it in POST format, you must add this value
            "name1":"value1",//your key
            "name2":123456,
            ...
        },

    }
}

Reponse Example

Code Block
{
    "errorId": 0,
    "errorCode": "",
    "errorDescription": "",
    "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006" // Please save this ID for next step
}

...

Parameter

Type

Description

errorId

Integer

Error message: 0 - no error, 1 - error

errorCode

string

Error code, click here to view all error list

errorDescription

string

Detailed error description

status

String

processing - task is in progress, please try again in 3 seconds

ready - task is complete, find the result in the solution parameter

solution

Object

The recognition result will be different for different types of captcha. For reCaptcha, the result is gRecaptchaResponse in the object.

solution.gRecaptchaResponse

string

Recognition result: response value, used for POST or simulated submission to the target website.The validity period is generally 120s, it is recommended to use within 60s

Response Example

Code Block
{
    "errorId": 0,
    "errorCode": null,
    "errorDescription": null,
    "solution": {
      {
        "gRecaptchaResponse": "03AGdBq25SxXT-pmSeBXjzScW-EiocHwwpwqtk1QXlJnGnU......"header": {
          "accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7", 
          "accept-encoding": "gzip, deflate, br, zstd", 
          ...
          "user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36"
        }, 
        "cookies": {
          "cf_clearance": "suAu.vzSYU4etZ2lc1FVhVhoAtKrKjHvbLn1.qY8m0E-1736763580-1.2.1.1-NM03fWRNYkN_gYFO1n1nlzwe9MtiNmm9YIz7ujq_Jmh_FyJvg2YA7ImuXyD_9ouZ2XYy.G73Gude_Qpzx04subKCPhHeaRr1qTKicxeGV9p6GhU_z75.6OTi.FlDFXe7ogCYwyPMn3xZKzFkzpDqpHBUv5uq40LF7Z07PIEPizwE8XZuhlVBhVkgulsWu4QCkStR95HbJxGNmKOf0h2PZSJPSStyCV5XwpmAIuZy3Zhfm46r4gDAbh7q.Isx_nMjpo6WCGYrpQrFHAfZQWd6NshmfxQyVJmItilb1p2evZrt3aVQOhmaTpKOzM4E5Rhtc8i2xYtm_hUk9ToGQm_7_g", 
          ...
        }, 
        "body": "<!DOCTYPE html>\n<html lang="en">\n<head>\n   ..."
      }
    },
    "status": "ready"
}

Response Description

...