ZIP code targeting

✓Residential — supported—Rotating ISP — not supported—Rotating DC — not supported

The narrowest geographic option we offer.

Usage

curl -x USERNAME:[email protected]:8000 \
  https://api.ipify.org

curl --proxy-header "X-Rayobyte-Country: US" \
     --proxy-header "X-Rayobyte-Zip: 75201" \
     -x us-east.gw.rayobyte.com:8000 https://api.ipify.org

Value rules

Two to ten letters or digits. No spaces, no hyphens.

-zip-75201        US
-zip-sw1a         UK outward code

A UK postcode like SW1A 1AA has a space in it. Send the outward code only, -zip-sw1a. A space cannot survive a proxy password field, and a hyphen would start a new option.

Expect low volume

A ZIP code covers a few thousand households. The number of our devices online in one at any moment is small, and sometimes zero.

That means:

• Do not pair ZIP with a strict session. You are asking for one specific device in one specific postcode to stay online. It will not, for long.
• Do not build a pipeline that assumes throughput. Test the ZIP you need at the concurrency you need before you commit to it.
• A failure here usually means an empty pool, not a broken request. See Errors & retries.

If you need consistent volume in a small area, city targeting is a much safer level to sit at.