Skip to content
Rayobyte Docs

City targeting

Residential — supportedRotating ISP — not supportedRotating DC — not supported

The level most people reach for, and the first one narrow enough to run out of devices. Read the volume warning below before you build on it.

Usage

Section titled “Usage”
Terminal window
curl -x USERNAME:[email protected]:8000 \
  https://api.ipify.org
Terminal window
curl --proxy-header "X-Rayobyte-Country: US" \
     --proxy-header "X-Rayobyte-City: dallas" \
     -x us-east.gw.rayobyte.com:8000 https://api.ipify.org

Value rules

Section titled “Value rules”

Letters, underscores and full stops. Case is ignored. Multi-word cities use an underscore:

-city-los_angeles
-city-san_francisco

Do not use hyphens or spaces. A hyphen starts a new option, so -city-los-angeles asks for the city los and then tries to parse angeles as an option name.

City targeting narrows hard

Section titled “City targeting narrows hard”

A city is a much smaller slice of the pool than a country. Combined with a session or an ASN, it is easy to describe a set with no devices online in it, which fails the request rather than falling back to a nearby city.

If you are seeing a lot of failures, drop to state and see whether the volume you need exists at that level first.

Send the country too

Section titled “Send the country too”
Terminal window
# Which Springfield?
-city-springfield


# Better.
-country-US-region-illinois-city-springfield

Finding valid values

Section titled “Finding valid values”

The Geolocation picker in the dashboard lists the cities we currently have coverage in. It reads the live pool, so it reflects what is actually online now.

Was this page helpful?