Lista de proxies
Genere cadenas de proxy listas para usar para un paquete, con geo-targeting opcional y selección de formato.
GET /packages/:id/proxies
Devuelve una lista de cadenas de conexión proxy para el paquete dado. Por defecto la respuesta es texto plano (un proxy por línea), lo que facilita la importación en cualquier herramienta. Pase plain text (one proxy per line), making it trivially importable into any tool. Pass Accept: application/json to get a JSON envelope instead.
/api/v1/packages/{id}/proxiesParámetros de consulta
| Parámetro | Predeterminado | Descripción |
|---|---|---|
quantity | 10 | Número de cadenas de proxy a devolver (1–1000) |
type | rotating | rotating or sticky |
protocol | http | http or socks5 |
format | user:pass@host:port | Formato de salida — ver tabla a continuación |
countries | — | Códigos de país ISO 3166-1 alpha-2 separados por comas |
exclude_countries | — | Códigos de país separados por comas a excluir |
states | — | Nombres de estado (minúsculas, sin espacios, p.ej. california) |
cities | — | Nombres de ciudad (minúsculas, sin espacios, p.ej. newyork) |
zipcodes | — | Códigos ZIP/postales, separados por comas |
asns | — | Números de sistema autónomo (numérico, con o sin prefijo AS) |
exclude_states | — | Nombres de estado a excluir (minúsculas, sin espacios). 2× facturación. |
exclude_cities | — | Nombres de ciudad a excluir (minúsculas, sin espacios). 2× facturación. |
exclude_zipcodes | — | Códigos ZIP a excluir. 2× facturación. |
exclude_asns | — | ASNs a excluir (numérico). 2× facturación. |
sessid | — | ID de sesión sticky. Reutilice el mismo string en los próximos ~30 minutos para conservar la misma IP de salida sin ocupar un puerto sticky. |
sessttl | 30 | TTL de la sesión sticky en minutos (1–120). 30 minutos por defecto. |
unique_sessid | false | Cuando es true y sessid está fijado: los proxies generados comparten el prefijo sessid pero añaden sufijos únicos por línea (sessid.0, sessid.1, …) — útil para N sesiones sticky independientes en una sola petición. |
anonymous | false | true para devolver solo salidas de alta anonimidad. Puede reducir el tamaño del pool. |
2× facturación en estado / ciudad / ZIP / ASN
El targeting por estado, ciudad, ZIP y ASN aplica un multiplicador de tráfico 2× para los paquetes Residential, Mobile y Datacenter. Premium Residential está exento. El targeting por país (countries / exclude_countries) siempre es gratuito.
Formatos de salida
| valor de formato | Ejemplo de salida |
|---|---|
user:pass@host:port | abc123:pass7x9k2m@proxy.raxyproxy.com:823 |
host:port:user:pass | proxy.raxyproxy.com:823:abc123:pass7x9k2m |
user:pass:host:port | abc123:pass7x9k2m:proxy.raxyproxy.com:823 |
host:port@user:pass | proxy.raxyproxy.com:823@abc123:pass7x9k2m |
user:pass | abc123:pass7x9k2m |
host:port | proxy.raxyproxy.com:823 |
http://user:pass@host:port | http://abc123:pass7x9k2m@proxy.raxyproxy.com:823 |
socks5://user:pass@host:port | socks5://abc123:pass7x9k2m@proxy.raxyproxy.com:824 |
Ejemplos de filtrado geográfico
# US proxies only
curl "https://raxyproxy.com/api/v1/packages/12/proxies?quantity=5&countries=us" \
-H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
# US, UK, and Germany — rotating HTTP
curl "https://raxyproxy.com/api/v1/packages/12/proxies?quantity=10&countries=us,gb,de" \
-H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
# California only — note: 2× billing applies
curl "https://raxyproxy.com/api/v1/packages/12/proxies?quantity=5&countries=us&states=california" \
-H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
# New York city, sticky, SOCKS5, JSON response
curl "https://raxyproxy.com/api/v1/packages/12/proxies?quantity=3&countries=us&cities=newyork&type=sticky&protocol=socks5" \
-H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Accept: application/json"# Plain text response (default):
abc123def456:pass7x9k2m@proxy.raxyproxy.com:823
abc123def456:pass7x9k2m@proxy.raxyproxy.com:823
abc123def456:pass7x9k2m@proxy.raxyproxy.com:823{
"data": {
"package_id": 12,
"count": 3,
"billing_multiplier": 1.0,
"proxies": [
"abc123def456:pass7x9k2m@proxy.raxyproxy.com:823",
"abc123def456:pass7x9k2m@proxy.raxyproxy.com:823",
"abc123def456:pass7x9k2m@proxy.raxyproxy.com:823"
]
},
"meta": { "version": "v1" }
}Sesiones sticky: puerto vs sessid
Dos formas de conservar la misma IP de salida: conectarse a un puerto del rango sticky (10000–20000) — una IP por puerto — o adjuntar el parámetro sessid a las credenciales usando el puerto rotativo estándar. sessid es preferible cuando necesita muchas sesiones sticky concurrentes.
# Sticky session via sessid — same IP for 10 minutes, single proxy
curl "https://raxyproxy.com/api/v1/packages/12/proxies?quantity=1&countries=us&sessid=worker-7&sessttl=10" \
-H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
# Sticky session via port range — same IP per port, 100 distinct sticky exits in parallel
curl "https://raxyproxy.com/api/v1/packages/12/proxies?quantity=100&type=sticky" \
-H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
# 20 unique sessid sticky sessions on the standard rotating port — 20 isolated IPs, 30 min TTL
curl "https://raxyproxy.com/api/v1/packages/12/proxies?quantity=20&sessid=worker&unique_sessid=true&sessttl=30" \
-H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
# Anonymous-only US proxies, excluding California
curl "https://raxyproxy.com/api/v1/packages/12/proxies?quantity=10&countries=us&exclude_states=california&anonymous=true" \
-H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"Ejemplos de código
# Download 100 US proxies in URL format to a file
curl -s "https://raxyproxy.com/api/v1/packages/12/proxies?quantity=100&countries=us&format=http://user:pass@host:port" \
-H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-o proxies.txtimport requests
API_KEY = 'raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
PACKAGE_ID = 12
resp = requests.get(
f'https://raxyproxy.com/api/v1/packages/{PACKAGE_ID}/proxies',
params={
'quantity': 10,
'countries': 'us',
'format': 'http://user:pass@host:port',
},
headers={
'Authorization': f'Bearer {API_KEY}',
'Accept': 'text/plain',
},
timeout=10,
)
proxies = resp.text.strip().splitlines()
print(f'Got {len(proxies)} proxies')
# Use the first one
session = requests.Session()
session.proxies = {'http': proxies[0], 'https': proxies[0]}
ip = session.get('https://httpbin.org/ip', timeout=10).json()['origin']
print(f'My IP via proxy: {ip}')const API_KEY = 'raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx';
const PACKAGE_ID = 12;
const url = new URL(`https://raxyproxy.com/api/v1/packages/${PACKAGE_ID}/proxies`);
url.searchParams.set('quantity', '10');
url.searchParams.set('countries', 'us');
url.searchParams.set('format', 'http://user:pass@host:port');
const resp = await fetch(url, {
headers: { Authorization: `Bearer ${API_KEY}` },
});
const proxies = (await resp.text()).trim().split('\n');
console.log(`Got ${proxies.length} proxies`);
console.log(proxies[0]);