Integrations / Proxy setups / Mobile proxies
Mobile proxies, with a new IP you can trust.
Mobile proxies exit through a carrier’s network, and most providers give you a link that asks for a new IP. Save that link with the proxy and Browz uses it for Change IP: it calls the link once, then checks the proxy until it really comes out from a new address.
export BROWZ_TOKEN="$(cat ~/.browz/api-token)"
curl -s -X POST http://127.0.0.1:50333/api/v1/proxy/create -H "Authorization: Bearer $BROWZ_TOKEN" -H "Content-Type: application/json" -d '{
"name": "London mobile", "scheme": "socks5", "host": "203.0.113.77", "port": 9050,
"changeIpUrl": "https://provider.example/api/rotate?key=…"
}'Setup
Set it up.
Add the proxy and its change-IP link
In Proxies, edit the proxy and paste the provider’s change-IP URL. It is stored sealed like a password and never shown again. From the local API, send it as
changeIpUrl.Terminalexport BROWZ_TOKEN="$(cat ~/.browz/api-token)" curl -s -X POST http://127.0.0.1:50333/api/v1/proxy/create -H "Authorization: Bearer $BROWZ_TOKEN" -H "Content-Type: application/json" -d '{ "name": "London mobile", "scheme": "socks5", "host": "203.0.113.77", "port": 9050, "changeIpUrl": "https://provider.example/api/rotate?key=…" }'Give it to a profile
Assign the proxy in the profile drawer, or with
proxyIdfrom the API.Change IP when you need to
Stop the profiles on that proxy, then choose Change IP on the profile row. Browz calls the link, checks the proxy every 5 seconds up to 8 times, and accepts the change only when the exit IP is really new and in the same country.
Terminalcurl -s -X POST http://127.0.0.1:50333/api/v1/proxy/change-ip -H "Authorization: Bearer $BROWZ_TOKEN" -H "Content-Type: application/json" \ -d '{"id":"<proxy id>"}'
Example
Plan a profile’s change first, then apply it.
On a profile, Change IP picks the way itself: the rotation link if its proxy has one, a new session for a provider-account proxy, or a swap to an unused matching proxy. Ask for the plan, then apply it.
curl -s -X POST http://127.0.0.1:50333/api/v1/profile/proxy/change-ip -H "Authorization: Bearer $BROWZ_TOKEN" -H "Content-Type: application/json" \
-d '{"id":"<profile id>"}' # the plan only
curl -s -X POST http://127.0.0.1:50333/api/v1/profile/proxy/change-ip -H "Authorization: Bearer $BROWZ_TOKEN" -H "Content-Type: application/json" \
-d '{"id":"<profile id>","apply":true}' # make the changeAdd "allowCountryChange": true only if a new exit in another country is acceptable; it resets the profile’s exit baseline.
Good to know
Notes and tips.
- Every profile on a mobile proxy gets the new IP when it changes, and a change cannot be undone. Stop those profiles first: a running profile keeps its old exit.
- Each link waits its cooldown (60 seconds unless you set another) before it can be called again.
- A change-IP link must point at a public internet address; links to this computer or your local network are refused.
- Leave a profile’s timezone, language and WebRTC on automatic: Browz sets them from where the proxy really exits, measured at each check, so the profile does not contradict its own address.
- Bring proxies from any provider: Browz supports HTTP, HTTPS, SOCKS4, SOCKS5 and SSH.
- A profile whose proxy fails its exit check is refused at Start. It never falls back to your own connection.
- A proxy changes where a profile connects from, not what a site allows. Use each site only as its terms allow; our acceptable use policy applies whatever the exit.
FAQ
Mobile proxies and Browz.
Why does Browz check the proxy after calling the link?
A provider can answer “done” and keep the same IP. Browz counts a change only when the exit it measures through the proxy is really new.
What if the new IP is in another country?
The change is not applied unless you allowed a country change. If a rotation ends up somewhere you did not expect, every profile on that proxy is held until you accept the new exit or give it another proxy.
Can I rotate many mobile proxies at once?
Yes: Change IP (all) in Proxies rotates every proxy with a link, one after another, and waits between calls to the same provider.
Get started
Download Browz. Every task, its own browser.
curl -fsSL https://gobrowz.com/agents/install.sh | sh