How to Connect

Connection details

Parameter	Value
Host	connect.trueproxies.com
HTTP Port	8080
SOCKS5 Port	1080
Authentication	Username & password or IP whitelisting

Username format

The proxy username supports parameters for geo-targeting and session control:

base_username[-country-XX][-city-name][-session-ID]

Parameter	Format	Example	Description
Country	-country-XX	-country-us	ISO 3166-1 alpha-2 country code
City	-city-name	-city-newyork	Target a specific city (lowercase, no spaces)
Session	-session-ID	-session-abc123	Sticky session — same ID = same IP for the session duration

Examples

Username	Behavior
user123	Random country, random IP each request
user123-country-us	US IP, rotating per request
user123-country-de-city-berlin	Berlin, Germany IP
user123-country-us-session-mysess1	Sticky US IP for session mysess1

For the complete list of 150 supported countries with IP counts, see the locations page.

Code examples

cURL

# Basic request
curl -x http://connect.trueproxies.com:8080 \
  -U "user123:password" \
  https://httpbin.org/ip

# With country targeting
curl -x http://connect.trueproxies.com:8080 \
  -U "user123-country-us:password" \
  https://httpbin.org/ip

# SOCKS5
curl -x socks5://connect.trueproxies.com:1080 \
  -U "user123:password" \
  https://httpbin.org/ip

Python

import requests

proxy_url = "http://user123-country-us:password@connect.trueproxies.com:8080"
proxies = {"http": proxy_url, "https": proxy_url}

response = requests.get("https://httpbin.org/ip", proxies=proxies)
print(response.json())

# SOCKS5 (requires requests[socks])
socks_url = "socks5://user123:password@connect.trueproxies.com:1080"
proxies_socks = {"http": socks_url, "https": socks_url}

response = requests.get("https://httpbin.org/ip", proxies=proxies_socks)
print(response.json())

JavaScript

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

const agent = new HttpsProxyAgent(
  'http://user123-country-us:password@connect.trueproxies.com:8080'
);

const response = await axios.get('https://httpbin.org/ip', {
  httpsAgent: agent,
});
console.log(response.data);

Go

package main

import (
    "fmt"
    "net/http"
    "net/url"
    "io"
)

func main() {
    proxyURL, _ := url.Parse("http://user123-country-us:password@connect.trueproxies.com:8080")
    client := &http.Client{
        Transport: &http.Transport{Proxy: http.ProxyURL(proxyURL)},
    }

    resp, err := client.Get("https://httpbin.org/ip")
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

Caution

Always use HTTPS for the target URL when possible. The proxy connection itself can be HTTP or SOCKS5, but the tunneled traffic to the destination should be encrypted.

IP whitelisting (alternative auth)

Instead of username/password, you can whitelist your server’s IP address for authentication-free access. See IP Whitelisting for details.