Skip to main content
Every example uses the same connection details. Replace USERNAME and SECRET with your credentials, and adjust the targeting tokens (-country-us, -session-…) to taste.
FieldValue
Proxy URLhttp://USERNAME-country-us:SECRET@proxy.illusory.io:1080
Host (recommended)proxy.illusory.io
IP (alternative)160.202.129.71
Port1080
ProtocolsHTTP/HTTPS and SOCKS5
The domain and IP are interchangeable. Examples below use the domain; swap in 160.202.129.71 if you prefer to connect by IP.

​
curl

curl -x "http://USERNAME-country-us:SECRET@proxy.illusory.io:1080" https://api.ipify.org

​
Python (requests)

import requests

proxy = "http://USERNAME-country-us:SECRET@proxy.illusory.io:1080"
proxies = {"http": proxy, "https": proxy}

r = requests.get("https://api.ipify.org?format=json", proxies=proxies, timeout=30)
print(r.json())  # the residential exit IP
For a sticky session, add a session token to the username: 
proxy = "http://USERNAME-country-us-session-checkout1-sesstime-30:SECRET@proxy.illusory.io:1080"

​
Node (axios)

import axios from "axios";
import { HttpsProxyAgent } from "https-proxy-agent";

const proxy = "http://USERNAME-country-us:SECRET@proxy.illusory.io:1080";
const agent = new HttpsProxyAgent(proxy);

const { data } = await axios.get("https://api.ipify.org?format=json", {
  httpAgent: agent,
  httpsAgent: agent,
});
console.log(data); // the residential exit IP

​
Browser (FoxyProxy)

  1. Install the FoxyProxy extension (Chrome or Firefox).
  2. Add a new proxy:
    • Type: HTTP
    • Host: proxy.illusory.io
    • Port: 1080
    • Username: USERNAME-country-us (add any targeting tokens here)
    • Password: SECRET
  3. Enable the proxy and browse. Your traffic now exits through a residential IP.
Because targeting lives in the username, you can save multiple FoxyProxy entries (one per country or session) and switch between them instantly.

​
Tips

  • For best throughput, run multiple parallel requests with rotating mode. Residential bandwidth aggregates across peers.
  • Use socks5h:// (not socks5://) with curl so DNS is resolved through the proxy.
  • Keep sticky sessions short-lived and scoped to a single flow.