Documentation Index
Fetch the complete documentation index at: https://docs.roundproxies.com/llms.txt
Use this file to discover all available pages before exploring further.
Use these copy-paste examples to send your first authenticated request through Roundproxies. Replace USERNAME, PASSWORD, and the gateway host with the values from your dashboard.
Credentials are tied to your account. Grab them from the dashboard before running any of the snippets below.
Proxy Endpoint
All examples on this page point at the same gateway. Adjust the host and port to match the network you’re using (residential, datacenter, or ISP).
http://USERNAME:PASSWORD@gate.roundproxies.com:8000
Components Breakdown
| Component | Description | Example |
|---|
| Host | Proxy gateway hostname | gate.roundproxies.com |
| Port | Connection port | 8000 |
| Username | Your account username | USERNAME |
| Password | Authentication password | PASSWORD |
| Target | The URL you want to scrape | https://httpbin.org/ip |
Python
The requests library is the most popular choice for synchronous scraping in Python.
import requests
proxies = {
"http": "http://USERNAME:PASSWORD@gate.roundproxies.com:8000",
"https": "http://USERNAME:PASSWORD@gate.roundproxies.com:8000",
}
r = requests.get("https://httpbin.org/ip", proxies=proxies, timeout=30)
print(r.json())
Node.js
Use axios together with https-proxy-agent to route both HTTP and HTTPS traffic through the gateway.
import axios from "axios";
import { HttpsProxyAgent } from "https-proxy-agent";
const agent = new HttpsProxyAgent(
"http://USERNAME:PASSWORD@gate.roundproxies.com:8000"
);
const { data } = await axios.get("https://httpbin.org/ip", {
httpAgent: agent,
httpsAgent: agent,
});
console.log(data);
The standard net/http package supports proxies out of the box via http.ProxyURL.
package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
proxyURL, _ := url.Parse("http://USERNAME:PASSWORD@gate.roundproxies.com:8000")
client := &http.Client{
Transport: &http.Transport{Proxy: http.ProxyURL(proxyURL)},
}
resp, _ := client.Get("https://httpbin.org/ip")
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
PHP
PHP’s bundled cURL bindings make routing requests through Roundproxies a one-liner.
<?php
$ch = curl_init("https://httpbin.org/ip");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_PROXY, "gate.roundproxies.com:8000");
curl_setopt($ch, CURLOPT_PROXYUSERPWD, "USERNAME:PASSWORD");
echo curl_exec($ch);
curl_close($ch);
Ruby
The standard library’s Net::HTTP::Proxy factory wraps Net::HTTP with proxy auth.
require "net/http"
require "uri"
uri = URI("https://httpbin.org/ip")
proxy = Net::HTTP::Proxy(
"gate.roundproxies.com", 8000, "USERNAME", "PASSWORD"
)
puts proxy.get_response(uri).body
cURL
The fastest way to verify your credentials from a shell.
curl -x "http://USERNAME:PASSWORD@gate.roundproxies.com:8000" \
https://httpbin.org/ip