Get Proxy

Get Proxy

Obtain a proxy endpoint optimized for your target.

Endpoint

GET /v1/proxy

Parameters

Parameter	Type	Required	Description
target	string	Yes	Target domain (e.g. amazon.com)
session_lock	boolean	No	Keep same IP for session (default: false)
country	string	No	ISO 3166-1 alpha-2 country code
ip_type	string	No	residential, datacenter, or dedicated
session_ttl	integer	No	Session timeout in seconds (default: 1800)
auto_heal	boolean	No	Enable auto-failover (default: true)

Request

curl "https://api.hydraskill.ai/v1/proxy?target=amazon.com&session_lock=true&country=US" \
  -H "Authorization: Bearer sk-your-key"

Response

{
  "proxy_id": "px_abc123",
  "host": "us-res-42.proxy.hydraskill.ai",
  "port": 8080,
  "username": "session_abc123",
  "password": "px_token_xyz",
  "ip": "203.0.113.42",
  "country": "US",
  "type": "residential",
  "session_lock": true,
  "expires_at": "2026-05-30T16:30:00Z",
  "protocol": "http"
}

Usage with HTTP Client

proxy = client.get_proxy(target="amazon.com", session_lock=True)

# Convert to requests-compatible dict
proxies = proxy.to_dict()
# {'http': 'http://user:pass@host:port', 'https': 'http://user:pass@host:port'}

response = requests.get(url, proxies=proxies)

Error Codes

Code	Meaning
400	Missing required parameter target
401	Invalid API key
402	Insufficient balance / plan limit reached
429	Rate limit exceeded
503	No available proxies for requested criteria