Lista de proxies
DocsLista de proxies

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.

GET/api/v1/packages/{id}/proxies

Parámetros de consulta

ParámetroPredeterminadoDescripción
quantity10Número de cadenas de proxy a devolver (1–1000)
typerotatingrotating or sticky
protocolhttphttp or socks5
formatuser:pass@host:portFormato de salida — ver tabla a continuación
countriesCódigos de país ISO 3166-1 alpha-2 separados por comas
exclude_countriesCódigos de país separados por comas a excluir
statesNombres de estado (minúsculas, sin espacios, p.ej. california)
citiesNombres de ciudad (minúsculas, sin espacios, p.ej. newyork)
zipcodesCódigos ZIP/postales, separados por comas
asnsNúmeros de sistema autónomo (numérico, con o sin prefijo AS)
exclude_statesNombres de estado a excluir (minúsculas, sin espacios). 2× facturación.
exclude_citiesNombres de ciudad a excluir (minúsculas, sin espacios). 2× facturación.
exclude_zipcodesCódigos ZIP a excluir. 2× facturación.
exclude_asnsASNs a excluir (numérico). 2× facturación.
sessidID 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.
sessttl30TTL de la sesión sticky en minutos (1–120). 30 minutos por defecto.
unique_sessidfalseCuando 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.
anonymousfalsetrue 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 formatoEjemplo de salida
user:pass@host:portabc123:pass7x9k2m@proxy.raxyproxy.com:823
host:port:user:passproxy.raxyproxy.com:823:abc123:pass7x9k2m
user:pass:host:portabc123:pass7x9k2m:proxy.raxyproxy.com:823
host:port@user:passproxy.raxyproxy.com:823@abc123:pass7x9k2m
user:passabc123:pass7x9k2m
host:portproxy.raxyproxy.com:823
http://user:pass@host:porthttp://abc123:pass7x9k2m@proxy.raxyproxy.com:823
socks5://user:pass@host:portsocks5://abc123:pass7x9k2m@proxy.raxyproxy.com:824

Ejemplos de filtrado geográfico

geo-examples.sh
# 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"
proxies-plain.txt
# Plain text response (default):
abc123def456:pass7x9k2m@proxy.raxyproxy.com:823
abc123def456:pass7x9k2m@proxy.raxyproxy.com:823
abc123def456:pass7x9k2m@proxy.raxyproxy.com:823
proxies-json.json
{
  "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-sessid.sh
# 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

proxies.sh
# 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.txt
proxies.py
import 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}')
proxies.mjs
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]);