Skip to main content

GET

Rotate proxies to get new IP addresses

Rotates the specified proxies to assign them new IP addresses.

Unlike other operations, rotating a proxy doesn't involve calling a specific API endpoint. Instead, you initiate a rotation by making any HTTP request through the proxy you wish to rotate, using a special username format.

To rotate a proxy, set the proxy username to rotate=must and send any request through the proxy. The proxy server will intercept this request, perform the rotation, and return the response body if successful.

We use api.ipify.org as an example because it returns the IP address of the requestor, allowing you to verify that the rotation was successful and immediately see the new IP address.

Examples:

curl --proxy http://rotate=must:PROXY_PASSWORD@PROXY_REGION.globalbyte.io:10000 http://api.ipify.org

Replace PROXY_PASSWORD with the actual password of the proxy you whish to rotate, PROXY_REGION with the proxy region (the first part of the proxy host), and any_url with any valid URL.

Responses

Code: 200

Description: Successfully rotated the proxy. Returns the requested URL.

Content Type: text/plain

172.59.208.148

Code: 429

Description: Rotation request was made too recently. Proxies can only be rotated once every 3 minutes.

Content Type: text/plain

Rotation requested too fast; allowed at most every 3 minutes

Code: 500

Description: An internal server error occurred during the rotation process.

Content Type: text/plain

Internal Server Error

Code: 401

Description: Unauthorized. The provided proxy password is invalid.

Content Type: text/plain

Unauthorized
172.59.208.148