Rotation
Getting a new IP: by hand, by link or on a timer
A ProxyGuys proxy holds on to its IP until you change it or the mobile network does. You can ask for a new one with a click, from a link a script opens, through the API, or let the dashboard rotate it for you on a timer. All of these become available once you've pressed Start proxy.
Which one to use
- A single new IP right now: the Change IP button.
- A new IP triggered by a script, bot or scheduler: the change-IP link.
- A different city as well as a new IP: the random-location link or the Random city button.
- New IPs without touching anything: automatic rotation.
- Full control from your own code: the API.
The Change IP button
On My Proxies, press Change IP on the proxy, or open its ⋮ menu (More actions on smaller screens) and pick Rotate IP now. The new IP stays in the same city on the same carrier. It usually arrives within 30 to 90 seconds, and you can ask for one once every 60 seconds.
Change-IP and random-location links
Each proxy has a private link that changes its IP whenever it's opened. It needs no login or API key, so a script, a scheduled job or a browser bookmark can all use it.
- ⋮ → Copy change-IP link copies it. Opening it replies "OK — rotating your IP now. Allow up to ~90 seconds for the new IP."
- ⋮ → Copy random-location link copies the same link with
/randomon the end. That one moves the proxy to a random city with a new IP. Add?excluded_carriers=att,tmobileto leave those carriers out. - ⋮ → New change-IP link swaps in a fresh link, and the old one stops working.
The Rotate URLs card on the API page lists both links for every proxy on your account, with New URLs to replace them.
Automatic rotation
The Rotation column on My Proxies (the rotation block on each card, on smaller screens) holds three settings. Only one can be on for a proxy at a time:
- IP rotation, "Same city & carrier": a new IP, location unchanged.
- Location rotation, "Random across full pool": a new city each time, from the whole network.
- Location · keep carrier, "Random city, same carrier": a new city on the carrier you already have.
Choose Every 5 min, Every 10 min, Every 30 min or Hourly, or No rotation to stop. The first change comes one interval after you save, and rotation keeps going with the dashboard closed.
Rotating from the API
Create a key on the API page with Create key and store it straight away, since it's shown only once. Your proxy's API id (it looks like pp123456) is different from its login. A rotate call answers when the change is done and includes new_ip, which can be null. Asking too soon returns a 409 with code: "cooldown" and a retry_after value in seconds. The schedule modes same_city, full_pool and same_carrier match the three dashboard settings above.
export PROXYGUYS_API_KEY="YOUR_API_KEY"
API="https://proxyguys.com/api/v1"
# New IP now, same city and carrier
curl -X POST "$API/proxies/pp123456/rotate" \
-H "Authorization: Bearer $PROXYGUYS_API_KEY"
# Rotate every 10 minutes, keeping city and carrier
curl -X PUT "$API/proxies/pp123456/rotation-schedule" \
-H "Authorization: Bearer $PROXYGUYS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"interval_minutes": 10, "mode": "same_city"}'
# Switch automatic rotation off
curl -X DELETE "$API/proxies/pp123456/rotation-schedule" \
-H "Authorization: Bearer $PROXYGUYS_API_KEY"
# Fetch this proxy's change-IP and random-location links
curl "$API/proxies/pp123456/rotate-links" \
-H "Authorization: Bearer $PROXYGUYS_API_KEY"Checking the result
Request https://api.ipify.org?format=json through the proxy before and after a change. If the IP looks the same, give it the full 90 seconds and check again. A lookup site may place the new IP in another city or state than the one you chose; lookup databases differ, and that's normal for mobile networks.
Bear in mind that a mobile IP can also change on its own: the carrier may reassign it, or the proxy may move to another phone at the same location. If your work depends on a steady IP, check it at the start of each session. When a site starts refusing you, see Blocked or flagged IP.