SOCKS Checker

Check whether SOCKS proxy IPs are live and accessible.

Submit IPs for Checking

POST /checkers/socks/

Request Body

Field	Type	Required	Description
ips	string[]	Yes	List of IP addresses to check

{
  "ips": [
    "146.112.128.85"
  ]
}

Response

{
  "ips": [
    "146.112.128.85"
  ]
}

Get Check Result

GET /checkers/socks/{id}/

Retrieve the result for a specific task by UUID.

Path Parameters

Parameter	Type	Description
id	string (uuid)	Task identifier

Response

{
  "id": "743e5273-70c6-47fa-96cf-9a8f8a9de6de",
  "status": "completed",
  "created_at": "2024-01-15T10:30:00Z",
  "report": "..."
}

Status Values

Status	Description
new	Just created. Not yet processed.
ready_to_perform_audit	Ready to run audit
processing	Waiting for report
completed	Finished (success or failed, details in report)

List All Results

GET /checkers/socks/

Retrieve all SOCKS check results for your account.

Query Parameters

Parameter	Type	Description
page	integer	Page number

Example

import time
import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://detect.expert/api/v1"
headers = {"X-Api-Key": API_KEY}

# Submit IPs
payload = {"ips": ["146.112.128.85"]}
response = requests.post(f"{BASE_URL}/checkers/socks/", json=payload, headers=headers)
print(response.json())

# Poll for results
task_id = "743e5273-70c6-47fa-96cf-9a8f8a9de6de"
while True:
    result = requests.get(f"{BASE_URL}/checkers/socks/{task_id}/", headers=headers)
    data = result.json()
    if data["status"] == "completed":
        print(data["report"])
        break
    time.sleep(5)