Skip to main content
You connect to residential proxies with a single endpoint and your account credentials. Targeting (country, city, session) is set right in the username.

​
Connection details

FieldValue
Host (recommended)proxy.illusory.io
IP (alternative)160.202.129.71
Port1080
UsernameYour Illusory username
PasswordYour proxy secret
ProtocolsHTTP/HTTPS and SOCKS5 (auto-detected)
Use the domain or the IP, whichever you prefer. We recommend the domain: it stays stable if our infrastructure changes, while the IP works identically today.
During the private beta, we provide your username and proxy secret directly. Keep your secret private. Anyone with it can use your balance.

​
Username format

Your username carries optional targeting tokens. With no tokens, you get a rotating IP from anywhere in the pool: 
<username>[-country-<cc>][-state-<st>|-city-<city>][-asn-<n>][-session-<id>[-sesstime-<min>]]
For example, to request a rotating US exit: 
<username>-country-us
See Targeting for every option and Sessions for sticky IPs.

​
Your first request

Replace USERNAME and SECRET with your credentials: 
curl -x "http://USERNAME-country-us:SECRET@proxy.illusory.io:1080" https://api.ipify.org
This prints the residential exit IP your request came from. Run it a few times. With no -session, each request rotates to a new IP.
If the returned IP is different from your own and changes between requests, you’re connected and rotating correctly.

​
Verify your location

Check that geo-targeting is working by inspecting the exit IP’s location: 
curl -x "http://USERNAME-country-gb:SECRET@proxy.illusory.io:1080" https://ipinfo.io/json
The country field in the response should match the country you targeted (gb in this example).

​
Troubleshooting

Your username or secret is wrong, or the secret was rotated. Re-check your credentials.
Sticky sessions pin a single residential peer, whose quality can vary. Try a rotating request (omit -session), or start a new session id.
You may have run out of balance. Reach out to top up your GB during the beta.