POST
/
public
/
user
/
proxy_test_run
/
create
{
  "created": [
    "5b1494e7-663f-4af6-adf8-67ec8b18cf66"
  ],
  "data": {
    "db8cd8d3-bc99-4880-9a1d-233af9a35eda": {
      "results": [
        {
          "proxy_test_result_id": "38c1c64b-af29-4e3d-93f2-4c1a1a313ac5",
          "proxy_test_run_id": "5b1494e7-663f-4af6-adf8-67ec8b18cf66",
          "proxy_tester_proxy_id": "db8cd8d3-bc99-4880-9a1d-233af9a35eda",
          "proxy_test_result_url": "https://google.com",
          "proxy_test_result_status_code": 200,
          "proxy_test_result_protocol": "http",
          "proxy_test_result_response_time": 224,
          "proxy_test_server_id": "london-2-digitalocean-proxytester-1",
          "proxy_test_server_city_id": 383210,
          "proxy_test_server_city_name": "London",
          "proxy_test_server_country_id": "gb",
          "proxy_test_result_creation_datetime": "2025-01-24 09:34:56",
          "proxy_test_result_last_update_datetime": "2025-01-24 09:34:56",
          "proxy_username": "ftrdddgq",
          "proxy_host": "148.135.178.94",
          "proxy_port": 5655,
          "proxy_ip_address": "148.135.178.94",
          "proxy_country_id": "fr",
          "proxy_city_id": 4137,
          "proxy_city_name": "New York City",
          "proxy_asn_id": 29802,
          "proxy_asn_name": "AS29802 HIVELOCITY, Inc."
        }
      ]
    }
  },
  "message": "Successfully returned proxy test run",
  "proxy_test_result_created": [
    "38c1c64b-af29-4e3d-93f2-4c1a1a313ac5"
  ],
  "proxy_tester_proxy_created": [
    "db8cd8d3-bc99-4880-9a1d-233af9a35eda"
  ]
}

Authorizations

​
X-API-Private-Key
string
header
required

Private API key for user-level authentication.

​
X-API-Public-Key
string
header
required

Public API key for user-level authentication.

Body

application/json

Proxy Test Run Request

​
proxies
object[]

The proxies to be tested

Maximum length: 20
Example:
[
  {
    "proxy_id": "8ca1bf7f-7e8e-490e-ad0a-715e5eb060a6",
    "proxy_string": "209.99.134.6:5702:ftrdddgq:518vrc41xyms"
  }
]
​
proxy_tester_server_id
string[]

ID of the server to test the proxy on (optional - all will be used if not provided)

Example:
["london-2-digitalocean-proxytester-1"]
​
urls
string[]

URLs to test the proxy against

Example:
["https://google.com"]

Response

200 - application/json

Successful proxy test creation

​
created
string[]

ID of the proxy test run object that was created

Example:
["5b1494e7-663f-4af6-adf8-67ec8b18cf66"]
​
data
object
Example:
{
  "db8cd8d3-bc99-4880-9a1d-233af9a35eda": {
    "results": [
      {
        "proxy_test_result_id": "38c1c64b-af29-4e3d-93f2-4c1a1a313ac5",
        "proxy_test_run_id": "5b1494e7-663f-4af6-adf8-67ec8b18cf66",
        "proxy_tester_proxy_id": "db8cd8d3-bc99-4880-9a1d-233af9a35eda",
        "proxy_test_result_url": "https://google.com",
        "proxy_test_result_status_code": 200,
        "proxy_test_result_protocol": "http",
        "proxy_test_result_response_time": 224,
        "proxy_test_server_id": "london-2-digitalocean-proxytester-1",
        "proxy_test_server_city_id": 383210,
        "proxy_test_server_city_name": "London",
        "proxy_test_server_country_id": "gb",
        "proxy_test_result_creation_datetime": "2025-01-24 09:34:56",
        "proxy_test_result_last_update_datetime": "2025-01-24 09:34:56",
        "proxy_username": "ftrdddgq",
        "proxy_host": "148.135.178.94",
        "proxy_port": 5655,
        "proxy_ip_address": "148.135.178.94",
        "proxy_country_id": "fr",
        "proxy_city_id": 4137,
        "proxy_city_name": "New York City",
        "proxy_asn_id": 29802,
        "proxy_asn_name": "AS29802 HIVELOCITY, Inc."
      }
    ]
  }
}
​
message
string

Response message from the API

Example:

"Successfully returned proxy test run"

​
proxy_test_result_created
string[]

IDs of the test result objects that were created

Example:
["38c1c64b-af29-4e3d-93f2-4c1a1a313ac5"]
​
proxy_tester_proxy_created
string[]

IDs of the proxy tester proxy objects that were created

Example:
["db8cd8d3-bc99-4880-9a1d-233af9a35eda"]