API Reference

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/data

Authentication

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:PORT

Proxy Endpoints

Available proxy gateway endpoints

Residential
HTTP/HTTPS
residential.proxyhat.com
Ports:8080, 8443

Premium residential IPs with AI-filtered quality routing

Datacenter
HTTP/HTTPS
dc.proxyhat.com
Ports:8080, 8443

High-speed datacenter proxies for bulk operations

Request Parameters

Customize your proxy requests with these options

ParameterTypeDescriptionExample
countrystringTarget country code (ISO 3166-1)country=US
citystringTarget city namecity=NewYork
sessionstringSticky session identifiersession=abc123
ttlnumberSession time-to-live in secondsttl=600

Code Examples

Implementation examples in popular languages

Python
import requests

proxy = "http://user:pass@residential.proxyhat.com:8080"
response = requests.get(
    "https://httpbin.org/ip",
    proxies={"http": proxy, "https": proxy}
)
Node.js
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 });
Go
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-IP

The proxy IP used for this request

Example:203.0.113.45
X-ProxyHat-Country

Country of the proxy IP

Example:US
X-ProxyHat-Latency

Request latency in milliseconds

Example:48

Error Codes

Common errors and how to handle them

CodeStatusDescriptionResolution
407Auth RequiredInvalid or missing credentialsCheck your username and password
429Rate LimitedToo many requestsReduce request frequency or upgrade plan
503UnavailableNo available proxies for criteriaTry a different country or wait

Rate Limits

Usage limits based on your plan

Starter
100
requests/minute
10 GB bandwidth
Pro
500
requests/minute
100 GB bandwidth
Enterprise
Unlimited
requests/minute
Unlimited bandwidth

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.