Friendly Captcha

Overview

SeatLabs provides an API endpoint that allows users to solve a Friendly Captcha challenge by submitting a site key and using a proxy for the requests. This API helps generate the required solution (friendlyCaptchaResponse) for various captchas, enabling automated processes to interact with CAPTCHA-protected sites.

API Endpoint

• URL: https://seatlabs.net/api/friendlyCaptcha

• Method: POST

Request Format

Headers

• Content-Type: application/json

Body Parameters

• apiKey (string, required): Your unique API key.

• siteKey (string, required): The site key associated with the CAPTCHA that needs to be solved. We can help you in our discord to help you find it: https://discord.gg/rFpcutkeQZ

• proxy (object, required): An object containing the proxy details used for the request. The object should include:

  • host (string, required): The proxy server's hostname or IP address.

  • port (integer, required): The port number on which the proxy server is running.

  • username (string, required): The username for proxy authentication.

  • password (string, required): The password for proxy authentication.

Example Request

Example 1: Solve a CAPTCHA using a proxy.

{
  "apiKey": "your-api-key-here",
  "siteKey": "site-key-from-captcha",
  "proxy": {
    "host": "proxy.example.com",
    "port": 8080,
    "username": "proxyUser",
    "password": "proxyPass"
  }
}

Response Format

Success Response

• success (boolean): Indicates whether the CAPTCHA was solved successfully.

• friendlyCaptchaResponse (string): The response string required to bypass the CAPTCHA.

Example Success Response

{
  "success": true,
  "friendlyCaptchaResponse": "0b7d3f65d3e5f6f123... (truncated)"
}

Error Response

If an error occurs, the response will contain details about the error.

Example Error Response: Insufficient Funds

{
  "message": "User not found or insufficient funds"
}

Example Error Response: Missing Required Parameters

{
  "message": "siteKey and a complete proxy object (host, port, username, password) are required"
}

Pricing

The cost for solving a CAPTCHA is as follows:

• Base Price: £0.07 per CAPTCHA solution

The cost will be deducted from your Labs balance when a successful solution is returned.

Retry Logic

The API implements automatic retry logic:

• Attempts: The API will try up to 3 times to solve the CAPTCHA using the provided proxy.

• Fallback: If all 3 attempts fail, the API will attempt to solve the CAPTCHA without using a proxy as a last resort.

Timeout

The API operation has a timeout of 3 seconds per request. If all requests fail, a fallback attempt without the proxy is made, and a final failure will result in an error being returned.

Supported Proxies

The API supports proxies that require both username and password for authentication. Ensure that the provided proxy details are accurate and operational.

Contact

For further assistance, join our discord https://discord.gg/rFpcutkeQZ.