Quickstart

Make your first cost-optimized proxy request in under 5 minutes.

1

Create your account

Head to proxysave.com/signup and create an account. You'll receive an API key immediately — no credit card required.

Your API key looks like ps_live_xxxxxxxxxxxxxxxx. Keep it safe — it authenticates all your requests.

2

Make your first request

ProxySave exposes a /fetch endpoint that proxies your request through the cheapest available provider. Pass your credentials and the target URL:

terminal
curl https://api.proxysave.com/fetch \
  -H "X-Openproxy-Username: your-username" \
  -H "X-Openproxy-Password: your-api-key" \
  -H "url: https://httpbin.org/ip" \
  -H "provider: cheapest"

The response is the proxied content from the target URL, returned exactly as the target sent it.

3

Set your constraints

Control costs by setting a maximum price per GB and a maximum response time. ProxySave only routes through providers that meet both constraints:

terminal
curl https://api.proxysave.com/fetch \
  -H "X-Openproxy-Username: your-username" \
  -H "X-Openproxy-Password: your-api-key" \
  -H "url: https://api.example.com/data" \
  -H "provider: cheapest" \
  -H "max-price-per-gb: 3.00" \
  -H "max-time-ms: 2000" \
  -H "label: product-scraper"

The label header tags this request for per-workload learning. ProxySave tracks provider performance per label, so routing improves over time for your specific use case.

4

See it working

As ProxySave routes requests, it builds a performance profile for your workload. You can see which providers are being selected and your cost savings in the dashboard:

response headers
X-ProxySave-Provider: netnut
X-ProxySave-Cost-Per-GB: 1.80
X-ProxySave-Latency-Ms: 842
X-ProxySave-Retries: 0

These response headers tell you exactly which provider was used, what it cost, and how long it took. Use them to monitor your savings programmatically.

Next steps

  • API Reference — full header spec, error codes, and response format
  • Providers — add your own provider keys (BYOK) for even lower costs
  • Routing — understand how constraint-based routing and learning work