قائمة الوكلاء
Docsقائمة الوكلاء

قائمة الوكلاء

قم بإنشاء سلاسل وكيل جاهزة للاستخدام لحزمة ما، مع استهداف جغرافي اختياري واختيار التنسيق.

GET /packages/:id/proxies

يُرجع قائمة بسلاسل اتصال الوكيل للحزمة المحددة. بشكل افتراضي الاستجابة نص عادي (وكيل واحد في كل سطر)، مما يجعل الاستيراد إلى أي أداة أمراً سهلاً. مرر 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

معاملات الاستعلام

المعاملالافتراضيالوصف
quantity10عدد سلاسل الوكيل المراد إرجاعها (1–1000)
typerotatingrotating or sticky
protocolhttphttp or socks5
formatuser:pass@host:portتنسيق الإخراج — انظر الجدول أدناه
countriesرموز دول ISO 3166-1 alpha-2 مفصولة بفواصل
exclude_countriesرموز الدول المراد استبعادها مفصولة بفواصل
statesأسماء الولايات (أحرف صغيرة، بدون مسافات، مثل california)
citiesأسماء المدن (أحرف صغيرة، بدون مسافات، مثل newyork)
zipcodesالرموز البريدية ZIP، مفصولة بفواصل
asnsأرقام النظام المستقل (رقمية، مع أو بدون بادئة AS)
exclude_statesأسماء الولايات للاستبعاد (أحرف صغيرة، بدون مسافات). فوترة 2×.
exclude_citiesأسماء المدن للاستبعاد (أحرف صغيرة، بدون مسافات). فوترة 2×.
exclude_zipcodesالرموز البريدية ZIP للاستبعاد. فوترة 2×.
exclude_asnsASNs للاستبعاد (رقمية). فوترة 2×.
sessidمعرّف الجلسة الثابتة. أعد استخدام نفس السلسلة خلال ~30 دقيقة للاحتفاظ بنفس IP الخروج دون شغل منفذ ثابت.
sessttl30TTL للجلسة الثابتة بالدقائق (1–120). 30 دقيقة افتراضيًا.
unique_sessidfalseعندما يكون true وتم ضبط sessid: تتشارك الوكلاء المولّدة بادئة sessid، لكن كل سطر يحصل على لاحقة فريدة (sessid.0، sessid.1، …) — مفيد لإنشاء N جلسات ثابتة مستقلة في طلب واحد.
anonymousfalsetrue لإرجاع المخارج عالية الإخفاء فقط. قد يُقلِّص حجم المجموعة.

فوترة 2× على الولاية / المدينة / ZIP / ASN

يطبق الاستهداف بالولاية والمدينة وZIP وASN مضاعفاً للحركة بمقدار 2× لحزم Residential وMobile وDatacenter. Premium Residential معفى منه. الاستهداف بالبلد (countries / exclude_countries) مجاني دائماً.

تنسيقات الإخراج

قيمة التنسيقمثال الإخراج
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

أمثلة التصفية الجغرافية

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

الجلسات الثابتة: المنفذ vs sessid

طريقتان للاحتفاظ بنفس IP الخروج: الاتصال بمنفذ من النطاق الثابت (10000–20000) — IP واحد لكل منفذ — أو إرفاق المعامل sessid بالاعتمادات واستخدام المنفذ الدوار القياسي. يُفضَّل sessid عند الحاجة إلى عدة جلسات ثابتة متزامنة.

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"

أمثلة الكود

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