Lista proxy
DocsLista proxy

Lista proxy

Generuj gotowe do użycia ciągi proxy dla pakietu z opcjonalnym geo-targetingiem i wyborem formatu.

GET /packages/:id/proxies

Zwraca listę ciągów połączeń proxy dla danego pakietu. Domyślnie odpowiedź jest zwykłym tekstem (jeden proxy na linię), co ułatwia import do dowolnego narzędzia. Przekaż 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

Parametry zapytania

ParametrDomyślnyOpis
quantity10Liczba ciągów proxy do zwrócenia (1–1000)
typerotatingrotating or sticky
protocolhttphttp or socks5
formatuser:pass@host:portFormat wyjściowy — patrz tabela poniżej
countriesRozdzielone przecinkami kody krajów ISO 3166-1 alpha-2
exclude_countriesRozdzielone przecinkami kody krajów do wykluczenia
statesNazwy stanów (małe litery, bez spacji, np. california)
citiesNazwy miast (małe litery, bez spacji, np. newyork)
zipcodesKody ZIP/pocztowe, rozdzielone przecinkami
asnsNumery systemu autonomicznego (numeryczne, z lub bez prefiksu AS)
exclude_statesNazwy stanów do wykluczenia (małe litery, bez spacji). Rozliczenie 2×.
exclude_citiesNazwy miast do wykluczenia (małe litery, bez spacji). Rozliczenie 2×.
exclude_zipcodesKody ZIP do wykluczenia. Rozliczenie 2×.
exclude_asnsASNs do wykluczenia (numeryczne). Rozliczenie 2×.
sessidID sesji sticky. Użyj tego samego ciągu w ciągu ~30 minut, aby zachować ten sam IP wyjściowy bez zajmowania portu sticky.
sessttl30TTL sesji sticky w minutach (1–120). Domyślnie 30 minut.
unique_sessidfalseGdy true i sessid ustawione: generowane proxy współdzielą prefiks sessid, ale każdy ma unikalny sufiks (sessid.0, sessid.1, …) — przydatne do N niezależnych sesji sticky w jednym żądaniu.
anonymousfalsetrue aby zwracać tylko wyjścia o wysokiej anonimowości. Może zmniejszyć pulę.

2× rozliczenie dla stan / miasto / ZIP / ASN

Targetowanie po stanie, mieście, ZIP i ASN stosuje mnożnik 2× ruchu dla pakietów Residential, Mobile i Datacenter. Premium Residential jest zwolniony. Targetowanie po kraju (countries / exclude_countries) jest zawsze bezpłatne.

Formaty wyjściowe

wartość formatuPrzykładowe wyjście
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

Przykłady filtrowania geo

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

Sesje sticky: port vs sessid

Dwa sposoby na utrzymanie tego samego IP wyjściowego: połączyć się z portem z zakresu sticky (10000–20000) — jeden IP na port — lub dołączyć parametr sessid do poświadczeń i użyć standardowego portu rotującego. sessid jest preferowany dla wielu jednoczesnych sesji sticky.

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"

Przykłady kodu

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