IPs and sessions

Every request leaves through a SIM card in a German 4G network. By default each request gets whichever modem is least busy, so consecutive requests usually come from different IPs.

Keep one IP: sessions

Send the same session name and your requests leave through the same modem, and so the same IP, for up to 10 minutes from the first request.

{ "url": "https://shop.example/cart", "session": "cart-42" }

A new IP: fresh_ip

"fresh_ip": true reconnects a modem to the mobile network before your request, which gives it a new address.

{ "url": "https://example.com/", "fresh_ip": true }

Mobile networks hand out addresses from a pool. A fresh IP is new for this modem, but it may be an address another subscriber used earlier.

Automatic rotation

You do not have to rotate anything. Modems change their IP on their own after a number of requests or a few minutes of use, while they are idle and no session is pinned to them.

IPv4 and IPv6

ip_versionBehaviour
"4"Default. The request uses the modem's IPv4 address.
"6"The request uses the modem's IPv6 address. The target must be reachable over IPv6.
"auto"IPv6 where the target supports it, otherwise IPv4.

Targets that are not reachable

Addresses in private or local networks (10.0.0.0/8, 192.168.0.0/16, 127.0.0.1, localhost, link-local and similar) are refused with target_not_allowed. This also applies when a public name resolves to such an address.