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

Authorizations

Path parameters

productDetailsIdstring · uuidRequired

Product Details Id

Responses

application/json

objectOptional

get

HTTPcURLJavaScriptPython

GET /v2/Renews/{productDetailsId} HTTP/1.1
Host: 
Authorization: Bearer JWT
Accept: */*

200

Success

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "owner": "123e4567-e89b-12d3-a456-426614174000",
  "creationDateTime": "2025-04-20T09:22:33.668Z",
  "lastUpdateDateTime": "2025-04-20T09:22:33.668Z",
  "isFeatured": true,
  "isAllowed": true,
  "weight": 1,
  "contextData": "text",
  "customData": "text",
  "productDetailsId": "123e4567-e89b-12d3-a456-426614174000",
  "bayId": "123e4567-e89b-12d3-a456-426614174000",
  "eachTimeSpan": {
    "ticks": 1,
    "days": 1,
    "hours": 1,
    "milliseconds": 1,
    "minutes": 1,
    "seconds": 1,
    "totalDays": 1,
    "totalHours": 1,
    "totalMilliseconds": 1,
    "totalMinutes": 1,
    "totalSeconds": 1
  }
}

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

Authorizations

Path parameters

productDetailsIdstring · uuidRequired

Product Details Id

Query parameters

delayinteger · int64Optional

The new delay (in minutes)

Responses

post

HTTPcURLJavaScriptPython

POST /v2/Renews/{productDetailsId} HTTP/1.1
Host: 
Authorization: Bearer JWT
Accept: */*

200

Success

No content

Delete an IP Renew

Remove the IP renew feature for a specific product.

Delete a specific renew

delete

Authorizations

Path parameters

productDetailsIdstring · uuidRequired

Product Details Id

Responses

delete

HTTPcURLJavaScriptPython

DELETE /v2/Renews/{productDetailsId} HTTP/1.1
Host: 
Authorization: Bearer JWT
Accept: */*

200

Success

No content

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

Authorizations

Path parameters

productDetailsIdstring · uuidRequired

Product Details Id

Responses

get

HTTPcURLJavaScriptPython

GET /v2/Renews/Execute/{productDetailsId} HTTP/1.1
Host: 
Authorization: Bearer JWT
Accept: */*

200

Success

No content