IP Rotation / Renewing

Introduction

The IP renew feature is available on some types of proxies like 4G proxies, it's a very useful feature that many of our customers use.

We are constantly improving this feature, we have reduced the renew speed of 4G proxies from more than 8 seconds to less than 5.

We currently support to kinds of IP rotation:

• Automatic: Define an IP rotation every X minutes.

• Manual: Triggers a rotation at the time of the request.

Configure Automatic Rotation

Get the IP Renew

Get the renew parameters for a specific product.

Get the IP renew for a product

GET/v2/Renews/{productDetailsId}

Path parameters

productDetailsId*string (uuid)

Product Details Id

Response

200

Success

Body

application/json

idstring (uuid)

ownernullable string (uuid)

creationDateTimenullable string (date-time)

lastUpdateDateTimenullable string (date-time)

isFeaturednullable boolean

isAllowednullable boolean

weightnullable integer (int32)

contextDatanullable string

customDatanullable string

productDetailsIdstring (uuid)

bayIdstring (uuid)

eachTimeSpanTimeSpan (object)

Request

JavaScriptCurl

const response = await fetch('/v2/Renews/{productDetailsId}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "owner": "123e4567-e89b-12d3-a456-426614174000",
  "creationDateTime": "2024-04-24T17:28:21.980Z",
  "lastUpdateDateTime": "2024-04-24T17:28:21.980Z",
  "isFeatured": false,
  "isAllowed": false,
  "contextData": "text",
  "customData": "text",
  "productDetailsId": "123e4567-e89b-12d3-a456-426614174000",
  "bayId": "123e4567-e89b-12d3-a456-426614174000",
  "eachTimeSpan": {
    "totalDays": 0,
    "totalHours": 0,
    "totalMilliseconds": 0,
    "totalMinutes": 0,
    "totalSeconds": 0
  }
}

Set a IP Renew Delay

Define the delay of renew for a specific product, the minimum renew is 1 minute.

Set a new IP renew delay

POST/v2/Renews/{productDetailsId}

Path parameters

productDetailsId*string (uuid)

Product Details Id

Query parameters

Response

200

Success

Request

JavaScriptCurl

const response = await fetch('/v2/Renews/{productDetailsId}', {
    method: 'POST',
    headers: {},
});
const data = await response.json();

Delete an IP Renew

Remove the IP renew feature for a specific product.

Delete a specific renew

DELETE/v2/Renews/{productDetailsId}

Path parameters

productDetailsId*string (uuid)

Product Details Id

Response

200

Success

Request

JavaScriptCurl

const response = await fetch('/v2/Renews/{productDetailsId}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Execute Manual Rotation

The manual renew will be executed as an asynchronous operation, the API will return the related requestId of the operation.

So don't worry if the request delay is really fast, it's just because it's asynchronous, the renew will be performed in the background and takes about 5 to 8 seconds.

Execute a manual renew of the proxy IP

GET/v2/Renews/Execute/{productDetailsId}

Path parameters

productDetailsId*string (uuid)

Product Details Id

Response

200

Success

Request

JavaScriptCurl

const response = await fetch('/v2/Renews/Execute/{productDetailsId}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();