Proxy-City Developer Docs

Getting started

1. Create a Proxy-City account and top up your bandwidth balance.
2. Open the dashboard and copy your username and password.
3. Point your HTTP client at gw.Proxy-City.io:7777.
4. Make your first request — your IP is now residential.

Authentication

All requests use basic auth. Credentials are visible in the dashboard and can be rotated at any time.

Username: customer-USERNAME
Password: PASSWORD
Endpoint: gw.Proxy-City.io:7777

Proxy format

Use a standard HTTP/HTTPS proxy URL. Append parameters to the username to control behavior.

http://customer-USER-country-us:PASSWORD@gw.Proxy-City.io:7777

Sticky vs rotating sessions

By default each request rotates IPs. To make a session sticky for up to 30 minutes, add a session ID:

# Rotating (default)
http://customer-USER:PASS@gw.Proxy-City.io:7777

# Sticky session
http://customer-USER-session-abc123:PASS@gw.Proxy-City.io:7777

Geo targeting

# Country
customer-USER-country-de

# City
customer-USER-country-us-city-new_york

# ASN
customer-USER-asn-15169

Code examples

curl -x http://customer-USER:PASS@gw.Proxy-City.io:7777 https://api.ipify.org

import requests

proxies = {
  "http":  "http://customer-USER:PASS@gw.Proxy-City.io:7777",
  "https": "http://customer-USER:PASS@gw.Proxy-City.io:7777",
}

r = requests.get("https://api.ipify.org", proxies=proxies)
print(r.text)

import fetch from "node-fetch";
import { HttpsProxyAgent } from "https-proxy-agent";

const agent = new HttpsProxyAgent(
  "http://customer-USER:PASS@gw.Proxy-City.io:7777"
);

const res = await fetch("https://api.ipify.org", { agent });
console.log(await res.text());

Common FAQs