Skip to content
Rayobyte Docs

How targeting works

Targeting narrows which exit IP you get. There are two ways to send it, and they are interchangeable, so pick whichever suits your client.

Options go on the password

Section titled “Options go on the password”

With username and password auth, you append -option-value to the password. Not the username.

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

This is the single most common mistake. Your real password still authenticates, because we strip the modifier run before checking it. A modifier bolted onto the username is just a username we do not recognize.

Order does not matter and you can stack as many as you like:

Terminal window
curl -x USERNAME:PASSWORD-country-US-region-texas-city-dallas-session-abc123@us-east.gw.rayobyte.com:8000 \
  https://api.ipify.org

Or send headers

Section titled “Or send headers”

Under IP whitelisting there is no password to append to, so every option has an X-Rayobyte-* equivalent. They work with password auth too.

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

Send both forms for the same option and the header wins.

The options

Section titled “The options”
Option Password form Header
Country -country-US X-Rayobyte-Country
State or region -region-texas X-Rayobyte-Region
City -city-dallas X-Rayobyte-City
ZIP code -zip-75201 X-Rayobyte-Zip
ASN -asn-7018 X-Rayobyte-Asn
Device OS -os-windows X-Rayobyte-Os
IP version -v4 / -v6 —
Sticky session -session-abc123 X-Rayobyte-Session
Strict sticky -hardsession-abc123 X-Rayobyte-Hardsession
Duration -duration-30 X-Rayobyte-Duration

Every one is listed with its exact value rules on All parameters.

Narrowing, and the empty pool

Section titled “Narrowing, and the empty pool”

Options combine with AND. -country-US-city-dallas means an exit that is in the US and in Dallas.

Narrow far enough and you will find combinations no exit matches. That returns a failure, not a looser match. We never quietly hand you a different city because the one you asked for was empty. See Errors & retries.

Unsupported options are ignored

Section titled “Unsupported options are ignored”

Rotating ISP and Rotating DC support country only. Sending -city-dallas to them does not error and does not narrow anything.

Check Feature availability before you build a pipeline around an option.

Was this page helpful?