Skip to content
Rayobyte Docs

Residential Proxies

Residential proxies route your traffic through real consumer IP addresses. By default every request exits from a different IP.
Gateway la.residential.rayobyte.com:8000
Billing by bandwidth (pay as you go or subscription)
Sub-accounts supported
IP authorisation supported

Basic request

Section titled “Basic request”
Terminal window
curl https://rayobyte.com/ \
  -x USERNAME:PASSWORD@la.residential.rayobyte.com:8000

Targeting and session options

Section titled “Targeting and session options”

Options are set one of two ways, depending on how you authenticate.

  • Username / password — append -key-value to the password, in any order, as many as you like.
  • IP authorisation — send an X-Rayobyte-* proxy header per option.
Option Password suffix Proxy header Value
Country -country-US X-Rayobyte-Country: US Two-letter ISO country code
Region -region-california X-Rayobyte-Region: california Region name
City -city-losangeles X-Rayobyte-City: losangeles City name
Soft sticky session -session-abc12345 X-Rayobyte-Session: abc12345 Any string you choose
Strict sticky session -hardsession-abc12345 X-Rayobyte-Hardsession: abc12345 Any string you choose
Session duration -duration-10 X-Rayobyte-Duration: 10 Minutes: 1, 5, 10, 15, 20, 25, 30, 60

Combine them freely:

Terminal window
curl https://rayobyte.com/ \
  -x USERNAME:PASSWORD-country-US-region-california-session-abc12345-duration-10@la.residential.rayobyte.com:8000

Geo-targeting rules

Section titled “Geo-targeting rules”
  • Country, region and city narrow in that order. A region without a country is ambiguous — always send the country too.
  • Omitting an option means random. Sending no geo options at all gives you an exit anywhere in the pool.
  • The dashboard’s Geolocation picker lists every country, region and city we currently have coverage for. That list is live; it is the authoritative answer to “can I get an exit in X?”.

Session types

Section titled “Session types”
Type Behaviour
Random (default) A new exit IP on every request.
Soft sticky (-session-) Reuses the same exit IP while it stays healthy. If that IP drops, you get a replacement and keep going.
Strict sticky (-hardsession-) Holds the exact same exit IP. If it becomes unavailable the request fails rather than silently moving.

Pick soft for throughput and strict for multi-step flows where changing IP mid-way breaks the target’s session.

Session IDs are arbitrary — any string works. The dashboard generates eight-character alphanumeric ones. Use a different ID per concurrent worker.

Without -duration-, a sticky session lasts for its default lifetime. With it, the session is held for that many minutes.

Generating a proxy list

Section titled “Generating a proxy list”

Some tools want a flat list rather than one endpoint. Proxy Access → Proxy List builds 100 ready-to-paste proxy strings with your chosen options and a fresh session ID on each line.

Section titled “Related”

Was this page helpful?