State & region targeting

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

One level below country. Useful when a target serves different content by state, or when you need volume that a single city cannot supply.

Usage

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

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

Value rules

Letters, underscores and full stops. Case is ignored. Multi-word regions use an underscore, never a space or a hyphen:

-region-new_york
-region-british_columbia

A hyphen would be read as the start of the next option, so -region-new-york targets the region new and then fails to parse york.

Always send the country

A region without a country is ambiguous. Several countries have a Georgia and a Victoria, and you will get whichever one the pool matched first.

# Ambiguous. Don't.
-region-georgia

# Unambiguous.
-country-US-region-georgia

Finding valid values

Use the Geolocation picker under Proxy Access → Customize Proxy Requests. It lists the regions we currently have coverage in, per country, and is generated from the live pool.

Region names come from the geolocation data attached to each exit, not from a fixed list we publish. A region with few devices online may match nothing right now and match fine an hour later.