Code Examples

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

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"

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

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

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

// For a sticky session, add a session token to the username:
// const proxy = "http://USERNAME-country-us-session-checkout1-sesstime-30:SECRET@proxy.illusory.io:1080";

use std::error::Error;

#[tokio::main]
async fn main() -> Result<(), Box<dyn Error>> {
    let proxy_url = "http://USERNAME-country-us:SECRET@proxy.illusory.io:1080";
    // For a sticky session, add a session token to the username:
    // let proxy_url = "http://USERNAME-country-us-session-checkout1-sesstime-30:SECRET@proxy.illusory.io:1080";
    // For SOCKS5, enable the `socks` cargo feature (reqwest = { version = "0.12", features = ["socks"] }) and use a socks5h:// URL.

    let client = reqwest::Client::builder()
        .proxy(reqwest::Proxy::all(proxy_url)?)
        .build()?;

    let ip: String = client
        .get("https://api.ipify.org")
        .send()
        .await?
        .text()
        .await?;

    println!("{ip}"); // the residential exit IP
    Ok(())
}