Skip to main content
POST
Check Proxies

Authentication

string
required
Your ClearProxy API key (format: clearpx_yourkey)
Alternatively, you can use Bearer token authentication:
string
Bearer token (format: Bearer clearpx_yourkey)

Request Body

array
required
Array of proxy addresses
string
Optional client-side generated job ID for real-time progress tracking via WebSockets
string
Region code (default: us1)
string
Proxy type: http, socks4, socks5 (default: http)
integer
Timeout in ms (1000-20000)
array
Array of custom URLs to validate working proxies against

Custom URL Parameters

string
required
Target URL to test proxies against
array
HTTP status codes to accept (default: [200])
string
Text that must appear in response body
boolean
Case-sensitive text matching (default: false)

Example Request

Example with Custom URL Validation

Response

object
Summary of check results
object
Detailed metadata about the request
string
URL to download full results