This guide shows you how to replace a problematic IP with a fresh one. You can request an IP replacement for a single proxy once per day. Processing may take some time.
Every request uses your personal API key from your account dashboard (how to get your API key). In the examples below, replace YOUR_API_KEY with your own key. To pay from your account balance, use paymentId = 1.
Step 1 — Find the proxies to replace
List your active proxies and copy the id of each one you want to replace. Note the proxy type.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/list/{type}
Response
{
"status": "success",
"data": {
"items": [
{ "id": "0678564", "ip": "31.6.33.97", "country_alpha3": "BEL", "status_type": "ACTIVE", "can_prolong": true, "date_end": "23.07.2024" }
]
},
"errors": []
}
Step 2 — Request the replacement
Submit the replacement request with the proxy ids, the type of replacement reason and an optional comment. The response returns the new IPs.
Endpoint
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/replace
Request body
Name | Type | Description |
ids | Number / Array | A single ID or an array of IDs in |
type | String | Replacement reason — see the allowed values below. |
comment (optional) | String | Optional comment to include with the request. |
Allowed type values: NOT_WORK, INCORRECT_LOCATION, CANT_CHANGE_NETWORK, LOW_SPEED, CUSTOM.
Example
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/replace
Response
{
"status": "success",
"data": {
"ok": {
"ips": [ "31.6.33.97" ],
"msg": "Replacement request submitted"
}
},
"errors": []
}
Full API reference
Retrieve active proxy — list your proxies