Skip to content

Usage of Solverify API

Solver URL: https://solver.solverify.net

Endpoints

  • POST /createTask - Creates a new CAPTCHA solving task.
  • POST /getTaskResult - Retrieves the result of a created task.
  • POST /getBalance - Retrieves the current balance of the user.

Errors

  • Standard error (typically inside HTTP 200): 

    {
  "errorId": 1,
  "errorCode": "ERROR_CODE_HERE",
  "errorDescription": "Human-readable explanation"
}

  • Error codes (name meaning)

    • ERROR_INTERNAL - Generic internal/server error.
    • ERROR_BANNED - Client IP temporarily banned for too many invalid requests (5 minute).
    • ERROR_TIMEOUT - Operation timed out.
    • ERROR_INVALID_KEY - API key not found/invalid.
    • ERROR_KEY_EXPIRED - API key has expired.
    • ERROR_USER_NOT_FOUND - No profile found for the API key's user.
    • ERROR_TASK_TYPE_NOT_FOUND - Submitted task type not supported.
    • ERROR_INSUFFICIENT_BALANCE - User balance is too low for the task price.
    • ERROR_PENDING_LIMIT_EXCEEDED - Non-subscription user has 100 pending tasks.
    • ERROR_BILLING_EXPIRED - Subscription billing/subscription expired.
    • ERROR_THREAD_LIMIT_EXCEEDED - Subscription user exceeded allowed concurrent threads/active tasks.
    • ERROR_TASK_CREATION_FAILED - Database insert failed when creating a task.
    • ERROR_TASK_NOT_FOUND - Task id not found in database.
    • ERROR_TASK_FAILED - Task stored with status "failed".
    • ERROR_UNKNOWN_STATUS - Task has an unexpected/unhandled status value.
    • ERROR_NO_NODES_AVAILABLE - No solver nodes are currently available to process the task.

Captcha Solving

Cloudflare Turnstile

  • Method: POST
  • Parameters:
    • clientKey - Your API key
    • websiteURL - The full URL of target web page where the captcha is loaded.
    • websiteKey - Turnstile sitekey. Can be found inside data-sitekey.
    • cdata - The cdata value for the turnstile (optional)
    • action - The action value of the turnstile (optional)

Example: 

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "turnstile",
    "websiteURL": "https://example.com",
    "websiteKey": "example_key",
    "cdata": "example_cdata",
    "action": "example_action"
  }
}

Response Example: 

{
  "errorId": 0,
  "taskId": "UUID"
}

Result Example: 

{
  "errorId": 0,
  "status": "completed",
  "solution": {
    "value": "0.MpR_tg_Jc9krcpY7vsFHAs"
  },
  "errorCode": null,
  "errorDescription": null
}

Cloudflare Interstitial

  • Method: POST
  • Parameters:
    • clientKey - Your API key
    • websiteURL - The full URL of target web page where the captcha is loaded.
    • useragent - User-Agent string to use for the request (optional)
    • proxyType - Proxy type allowed: http
    • proxyAddress - Proxy IP address or hostname
    • proxyPort - Proxy port
    • proxyLogin - Login for proxy (optional)
    • proxyPassword - Password for proxy (optional)

Example: 

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "interstitial",
    "websiteURL": "https://example.com",
    "useragent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Safari/537.36",
    "proxyType": "http",
    "proxyAddress": "1.1.1.1",
    "proxyPort": "80",
    "proxyLogin": "username",
    "proxyPassword": "password"
  }
}

Response Example: 

{
  "errorId": 0,
  "taskId": "UUID"
}

Result Example: 

{
  "errorId": 0,
  "status": "completed",
  "solution": {
    "value": "dce6748725944f29b43b64a5eaad3a",
    "cookies": {
      "cf_clearance": ".AdOHyy60coo8q0wL6TAJFu2V1"
    },
    "useragent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Safari/537.36"
  },
  "errorCode": null,
  "errorDescription": null
}

OCR

  • Method: POST
  • Parameters:
    • clientKey - Your API key
    • base64 - The base64 of the image to solve.

Example: 

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "ocr",
    "base64": "BASE64_ENCODED_IMAGE"
  }
}

Response Example: 

{
  "errorId": 0,
  "taskId": "UUID"
}

Get Results

  • Method: POST
  • Parameters:
    • clientKey - Your API key
    • taskId - The ID of the task to retrieve results for

Example: 

{
  "clientKey": "YOUR_API_KEY",
  "taskId": "UUID"
}

Response Example: 

{
  "errorId": 0,
  "result": {
    "solution":  {
      "value": "",
      "cookies": null,
      "useragent": null
    }
  }
}

Get Balance

  • Method: POST
  • Parameters:
    • clientKey - Your API key

Example: 

{
  "clientKey": "YOUR_API_KEY"
}

Response Example: 

{
  "errorId": 0,
  "balance": 5.1225,
  "errorCode": null,
  "errorDescription": null
}

Support

For any questions or assistance: Telegram