Country targeting
Values are ISO 3166-1 alpha-2 codes: two letters, case insensitive.
curl --proxy-header "X-Rayobyte-Country: DE" \ -x us-east.gw.rayobyte.com:8000 https://checkip.amazonaws.com| Country | Value |
|---|---|
| United States | US |
| United Kingdom | GB |
| Germany | DE |
| Japan | JP |
| Brazil | BR |
GB for the United Kingdom, not UK. UK is not an ISO code and matches
nothing.
Which countries we have
Section titled “Which countries we have”On Premium Residential, the Geolocation picker in the dashboard lists every country, state and city we currently have coverage for. It reads from the live pool, so it is the authoritative answer to “can I get an exit in X”. That answer changes as devices join and leave.
Cuba (CU), Iran (IR), North Korea (KP) and Syria (SY) are not in the picker
and cannot be targeted. Asking for one returns 451. See
Acceptable use
for every blocked location, and for how to ask support to review a block that affects
a legitimate business purpose.
Premium Rotating ISP and Premium Rotating DC
Section titled “Premium Rotating ISP and Premium Rotating DC”Country is the only location option on Premium Rotating ISP and Premium Rotating DC. Send it the same way, on the password or in the header.
curl -x USERNAME:PASSWORD-country-DE@YOUR_HOST:YOUR_PORT https://checkip.amazonaws.comA country with no exits on the product returns 551
and the request gets no exit. Coverage can change, so read a 551 as “no exit in that country
right now”.
Country is not the same as entry point
Section titled “Country is not the same as entry point”Connecting through us-east.gw.rayobyte.com and asking for -country-US
gives you a US exit. The entry point only decides where your connection
lands first, which affects latency and nothing else.
This confuses almost everybody once. Entry points explains it properly.
Narrowing further
Section titled “Narrowing further”On Premium Residential you can add state, city, ZIP and ASN.
Always send the country alongside them. A region name on its own is ambiguous. Several countries have a Georgia, a Victoria and a Santiago.
Was this page helpful?
Thanks. That helps us fix it.