Rotate your proxy IP on demand via a simple GET request. Respect your plan’s minimum IP change interval to avoid throttling.
https://iaproxy.com/api/change_ip.php?package_api_key=YOUR_PACKAGE_API_KEY
package_api_key secret. Do not share it publicly.The API enforces your plan’s minimum IP change interval (e.g., 1, 2, 4, 5, 7, or 10 minutes). If you call the endpoint too soon, you’ll receive a wait message with the remaining seconds.
GET https://iaproxy.com/api/change_ip.php?package_api_key=25be1c9190da0ca2b34f59b30d0eed97
HTTP 200
{
"Status": "Success",
"Message": "Success"
}
On success, upstream details are abstracted. You’ll receive a generic success message.
HTTP 200
{
"Status": "Error",
"Message": "Please wait 120 seconds"
}
Returned when the rotation is requested before your plan’s interval has elapsed.
HTTP 200
{
"Status": "Error",
"Message": "Missing package_api_key"
}
You must pass package_api_key as a query parameter.
HTTP 200
{
"Status": "Error",
"Message": "Please wait..."
}
Fallback when the upstream response can’t be confidently classified. The raw response is logged internally.
curl -sS "https://iaproxy.com/api/change_ip.php?package_api_key=YOUR_PACKAGE_API_KEY"
fetch("https://iaproxy.com/api/change_ip.php?package_api_key=YOUR_PACKAGE_API_KEY")
.then(r => r.json())
.then(console.log)
.catch(console.error);
import requests
url = "https://iaproxy.com/api/change_ip.php"
params = {"package_api_key": "YOUR_PACKAGE_API_KEY"}
r = requests.get(url, params=params, timeout=15)
print(r.json())
Success responses as non-rotations; retry after the suggested wait time.