قائمة الوكلاء
قم بإنشاء سلاسل وكيل جاهزة للاستخدام لحزمة ما، مع استهداف جغرافي اختياري واختيار التنسيق.
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.
/api/v1/packages/{id}/proxiesمعاملات الاستعلام
| المعامل | الافتراضي | الوصف |
|---|---|---|
quantity | 10 | عدد سلاسل الوكيل المراد إرجاعها (1–1000) |
type | rotating | rotating or sticky |
protocol | http | http or socks5 |
format | user: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_asns | — | ASNs للاستبعاد (رقمية). فوترة 2×. |
sessid | — | معرّف الجلسة الثابتة. أعد استخدام نفس السلسلة خلال ~30 دقيقة للاحتفاظ بنفس IP الخروج دون شغل منفذ ثابت. |
sessttl | 30 | TTL للجلسة الثابتة بالدقائق (1–120). 30 دقيقة افتراضيًا. |
unique_sessid | false | عندما يكون true وتم ضبط sessid: تتشارك الوكلاء المولّدة بادئة sessid، لكن كل سطر يحصل على لاحقة فريدة (sessid.0، sessid.1، …) — مفيد لإنشاء N جلسات ثابتة مستقلة في طلب واحد. |
anonymous | false | true لإرجاع المخارج عالية الإخفاء فقط. قد يُقلِّص حجم المجموعة. |
فوترة 2× على الولاية / المدينة / ZIP / ASN
يطبق الاستهداف بالولاية والمدينة وZIP وASN مضاعفاً للحركة بمقدار 2× لحزم Residential وMobile وDatacenter. Premium Residential معفى منه. الاستهداف بالبلد (countries / exclude_countries) مجاني دائماً.
تنسيقات الإخراج
| قيمة التنسيق | مثال الإخراج |
|---|---|
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 |
أمثلة التصفية الجغرافية
# 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" }
}الجلسات الثابتة: المنفذ vs sessid
طريقتان للاحتفاظ بنفس IP الخروج: الاتصال بمنفذ من النطاق الثابت (10000–20000) — IP واحد لكل منفذ — أو إرفاق المعامل sessid بالاعتمادات واستخدام المنفذ الدوار القياسي. يُفضَّل sessid عند الحاجة إلى عدة جلسات ثابتة متزامنة.
# 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"أمثلة الكود
# 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]);