PiratProxies

Automation and testing

How to use a proxy with Postman

Postman is the common desktop tool for trying out APIs. Its settings can send every request through a proxy you choose, which is a quick way to see what an API returns in another country.

Which proxy to use

Any plan with the country you need. Residential Lite is the cheapest way to see an API as a visitor from another country would.

What to enter

A PiratProxies plan gives you four things: a host, a port, a username and a password. These are the values for Residential; the username and password are on your plan page.

Hostresi.piratproxies.com
HTTP port8080
SOCKS5 port1080
UsernameUSERNAME
Passwordfrom your plan page

The country and the session are chosen in the username, not in a separate setting. The generator on your plan page writes the username for you, and Targeting and sessions explains each part.

Steps

  1. Open Settings, then Proxy.
  2. Switch on the custom proxy configuration and tick both HTTP and HTTPS.
  3. Enter the proxy server resi.piratproxies.com and the port 8080.
  4. Switch on proxy authentication and enter your username and password.
  5. Send a GET request to https://api.ipify.org to check the address.

Menu names can differ a little between versions of Postman. The four values to enter are always the same.

Rotating or sticky

If Postman is acting as one visitor through several steps, use a sticky session so the IP address stays the same throughout. If each run is independent, leave the session out and every run starts from a new address.

A sticky username looks like this:

USERNAME-country-us-time-600-session-a1b2c3d4

If it does not work

  • The setting applies to the whole app. Switch it off again when you are done, or every request keeps using your plan.
  • A 407 error means the username or password was not accepted. Copy both again from your plan page, and check that nothing added a space or cut the username short.
  • If the IP address is in the wrong country, look at the username: the country code is part of it. More fixes.

Questions

Which PiratProxies proxy should I use with Postman?

Any plan with the country you need. Residential Lite is the cheapest way to see an API as a visitor from another country would.

Postman is a product of its own makers. PiratProxies is not affiliated with it; the name is used here only to say what this guide is about. Use it within the rules of the sites you work with and our acceptable use policy.