Quick start

Get a working proxy request in three minutes.

This page assumes you have an account. If you do not, signing up takes under a minute and credits one gigabyte of residential traffic with no card.

1. Find your credentials

Open the dashboard, go to Proxy users, and either copy the default credential pair or create a new one. A proxy user is just a username and password with an optional traffic cap; most teams create one per project so usage is attributable.

2. Send a request

curl -x res.wproxy.io:8000 \
     -U "wp-acc4821:s3cr3t-pass" \
     https://ipinfo.io/json

If the response contains an IP address that is not yours, it worked. Run it a second time and you will get a different address — rotation is the default.

3. Pin it to a country

bash
curl -x res.wproxy.io:8000 \
     -U "wp-acc4821-country-de:s3cr3t-pass" \
     https://ipinfo.io/json

Append -country- and a two-letter ISO code to the username. Nothing else changes. The country field in the response should now read DE.

4. Hold the same address

bash
curl -x res.wproxy.io:8000 \
     -U "wp-acc4821-country-de-session-a91f:s3cr3t-pass" \
     https://ipinfo.io/json

Any string after -session- becomes a session key. Reuse it and you get the same exit for up to ten minutes by default, or up to 120 minutes if you add -sesstime-120.

That is the whole interface

Everything else in these docs is a variation on those four commands: different gateways, more targeting flags, and language-specific plumbing.

Next steps

Something inaccurate?Tell support