Proxy basics

What is a rotating proxy API?

A practical introduction to public proxy selection, verification and retries.


The idea.

A rotating proxy API returns an address from a proxy pool. Your application then sends its traffic through that proxy.

Your script gimmeproxy API Proxy address Your script Public proxy Destination

The API selects a proxy; it does not carry your web traffic.

Make your first request.

$ curl 'https://gimmeproxy.com/api/getProxy?curl=true'
Sample response
http://192.0.2.24:8080
HTTPS checked

Use the returned address with your HTTP client.

Choose your filters.

A filter narrows the current public pool. A matching proxy may not be available.

FilterExample
Countrycountry=BR
Protocolprotocol=socks5
FreshnessmaxCheckPeriod=600
Rotation is random.

A later API call can return the same proxy. This is not a guarantee of a new IP on every request.

Plan for timeouts.

  1. Set a request timeout.
  2. Request another proxy after failure.
  3. Back off when you hit API limits.

What verification tells you.

A proxy passed an HTTPS check at the recorded time. It may still stop working afterward.

Read how verification works

Keep building.

More guides to help you get the most from gimmeproxy.

Get a free proxy