Skip to content
Start free trial

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.

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

Terminal window
curl -x USERNAME:[email protected]:8000 https://checkip.amazonaws.com

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://checkip.amazonaws.com

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://checkip.amazonaws.com

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

OptionPassword formHeader
Country-country-USX-Rayobyte-Country
State or region-region-texasX-Rayobyte-Region
City-city-dallasX-Rayobyte-City
ZIP code-zip-75201X-Rayobyte-Zip
ASN-asn-7018X-Rayobyte-Asn
Device OS-os-windowsX-Rayobyte-Os
IP version-v4 / -v6—
Sticky session-session-abc123X-Rayobyte-Session
Strict sticky-hardsession-abc123X-Rayobyte-Hardsession
Duration-duration-30X-Rayobyte-Duration

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

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.

Some targets are refused outright: the sanctioned countries Cuba, Iran, North Korea and Syria, the occupied regions of Ukraine, Washington, DC, and the networks of governments, banks and other sensitive operators. Asking for one returns 451 with the header X-Rayobyte-Block-Reason: targeting, not a 551. Acceptable use has the full list. If a block affects a legitimate business purpose, contact support and we’ll review your use case.

Scale Residential has no location targeting and discards the options. Sending -city-dallas to it does not error and does not narrow anything.

Rotating ISP and Rotating DC do not discard them. On either tier, a country with no exits returns 551 rather than a looser match, and other location options can too.

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

Was this page helpful?