Liste de proxies

Générez des chaînes proxy prêtes à l'emploi pour un package, avec geo-targeting optionnel et sélection de format.

GET /packages/:id/proxies

Retourne une liste de chaînes de connexion proxy pour le package donné. Par défaut la réponse est du texte brut (un proxy par ligne), ce qui facilite l'importation dans n'importe quel outil. Passez 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

Paramètres de requête

Paramètre	Défaut	Description
`quantity`	`10`	Nombre de chaînes proxy à retourner (1–1000)
`type`	`rotating`	`rotating` or `sticky`
`protocol`	`http`	`http` or `socks5`
`format`	`user:pass@host:port`	Format de sortie — voir tableau ci-dessous
`countries`	—	Codes pays ISO 3166-1 alpha-2 séparés par des virgules
`exclude_countries`	—	Codes pays séparés par des virgules à exclure
`states`	—	Noms d'états (minuscules, sans espaces, ex. california)
`cities`	—	Noms de villes (minuscules, sans espaces, ex. newyork)
`zipcodes`	—	Codes ZIP/postaux, séparés par des virgules
`asns`	—	Numéros de système autonome (numérique, avec ou sans préfixe AS)
`exclude_states`	—	Noms d'états à exclure (minuscules, sans espaces). Facturation 2×.
`exclude_cities`	—	Noms de villes à exclure (minuscules, sans espaces). Facturation 2×.
`exclude_zipcodes`	—	Codes ZIP à exclure. Facturation 2×.
`exclude_asns`	—	ASNs à exclure (numérique). Facturation 2×.
`sessid`	—	ID de session sticky. Réutilisez la même chaîne dans les ~30 prochaines minutes pour conserver la même IP de sortie sans occuper un port sticky.
`sessttl`	`30`	TTL de la session sticky en minutes (1–120). 30 minutes par défaut.
`unique_sessid`	`false`	Si true et sessid défini : les proxies générés partagent le préfixe sessid mais reçoivent un suffixe unique par ligne (sessid.0, sessid.1, …) — utile pour N sessions sticky indépendantes en une seule requête.
`anonymous`	`false`	true pour ne renvoyer que des sorties à haute anonymat. Peut réduire la taille du pool.

2× facturation pour état / ville / ZIP / ASN

Le ciblage par état, ville, ZIP et ASN applique un multiplicateur de trafic 2× pour les packages Residential, Mobile et Datacenter. Premium Residential est exempt. Le ciblage par pays (countries / exclude_countries) est toujours gratuit.

Formats de sortie

valeur de format	Exemple de sortie
`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`

Exemples de filtrage géographique

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" }
}

Sessions sticky : port vs sessid

Deux façons de conserver la même IP de sortie : se connecter à un port de la plage sticky (10000–20000) — une IP par port — ou attacher le paramètre sessid aux credentials avec le port rotatif standard. sessid est préférable pour plusieurs sessions 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"

Exemples de code

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]);

← Précédent

Statistiques du package

Clés API