Documentation
Everything you need to integrate ProxyHat into your applications
Quick Start
Get up and running in minutes
curl -x http://USERNAME:PASSWORD@proxy.proxyhat.com:8080 \
https://api.example.com/dataAuthentication
Secure your API requests with your credentials
API Key Authentication
All requests require your API key to be passed in the proxy URL. Your API key can be found in your dashboard after signing up.
http://USERNAME:PASSWORD@proxy.proxyhat.com:PORTProxy Endpoints
Available proxy gateway endpoints
residential.proxyhat.comPremium residential IPs with AI-filtered quality routing
dc.proxyhat.comHigh-speed datacenter proxies for bulk operations
Request Parameters
Customize your proxy requests with these options
| Parameter | Type | Description | Example |
|---|---|---|---|
country | string | Target country code (ISO 3166-1) | country=US |
city | string | Target city name | city=NewYork |
session | string | Sticky session identifier | session=abc123 |
ttl | number | Session time-to-live in seconds | ttl=600 |
Code Examples
Implementation examples in popular languages
import requests
proxy = "http://user:pass@residential.proxyhat.com:8080"
response = requests.get(
"https://httpbin.org/ip",
proxies={"http": proxy, "https": proxy}
)const fetch = require('node-fetch');
const HttpsProxyAgent = require('https-proxy-agent');
const agent = new HttpsProxyAgent(
'http://user:pass@residential.proxyhat.com:8080'
);
fetch('https://httpbin.org/ip', { agent });proxyURL, _ := url.Parse(
"http://user:pass@residential.proxyhat.com:8080",
)
client := &http.Client{
Transport: &http.Transport{Proxy: http.ProxyURL(proxyURL)},
}
resp, _ := client.Get("https://httpbin.org/ip")Response Headers
Metadata returned with each proxied request
X-ProxyHat-IPThe proxy IP used for this request
203.0.113.45X-ProxyHat-CountryCountry of the proxy IP
USX-ProxyHat-LatencyRequest latency in milliseconds
48Error Codes
Common errors and how to handle them
| Code | Status | Description | Resolution |
|---|---|---|---|
407 | Auth Required | Invalid or missing credentials | Check your username and password |
429 | Rate Limited | Too many requests | Reduce request frequency or upgrade plan |
503 | Unavailable | No available proxies for criteria | Try a different country or wait |
Rate Limits
Usage limits based on your plan
Need higher limits?
Contact our team for custom enterprise plans with unlimited requests and dedicated infrastructure.
Ready to get started?
Create your account and start using our proxy infrastructure in minutes.
