تسجيل الدخولابدأ الآن
ابدأ الآن
المواقع
Docsالمواقع

اكتشاف المواقع

ابحث عن الدول والولايات والمدن وZIP وASN المتاحة لكل نوع مجموعة، لتبني فلاتر جغرافية من بيانات حقيقية بدلاً من تخمين الرموز.

جميع نقاط نهاية المواقع تقبل pool_type (إلزامي) وتُعيد مصفوفات {code, name, count}. استخدم قيم code مباشرة مع /packages/{id}/proxies و/default-geo. تخزين مؤقت ساعة واحدة على طبقة API + ذاكرات أطول من المزوّد — تظهر تغييرات الكتالوج خلال دقائق.

GET /locations/countries

يُعيد الدول المتاحة للمجموعة المختارة. لا حاجة للفلتر.

GET/api/v1/locations/countries?pool_type=residential
response.json
{
  "data": {
    "pool_type": "residential",
    "type":      "countries",
    "filters":   {},
    "count":     2,
    "items": [
      { "code": "us", "name": "United States", "count": 42398721 },
      { "code": "gb", "name": "United Kingdom", "count":  8123094 }
    ]
  },
  "meta": { "version": "v1" }
}

GET /locations/states

يُعيد الولايات داخل الدول المحدَّدة.

GET/api/v1/locations/states?pool_type=residential&countries=us

GET /locations/cities

يُعيد المدن داخل الدول المحدَّدة (اختياريًا مقيَّد بالولايات).

GET/api/v1/locations/cities?pool_type=residential&countries=us&states=california

GET /locations/zipcodes

يُعيد ZIP داخل الدول المحدَّدة (اختياريًا مقيَّد بالولايات).

GET/api/v1/locations/zipcodes?pool_type=residential&countries=us

GET /locations/asns

يُعيد ASN داخل الدول المحدَّدة (اختياريًا مقيَّد بالولايات/المدن).

GET/api/v1/locations/asns?pool_type=residential&countries=us

تنسيق الأكواد

الدول: أكواد ISO من حرفين بأحرف صغيرة (us، gb، de). الولايات والمدن: الاسم الكامل، أحرف صغيرة، بدون مسافات — california، newyork، sanfrancisco. ZIP: سلاسل رقمية. ASN: رقمي، بدون بادئة AS.

أمثلة الكود

locations.sh
# Pick top 5 US cities by available pool size, then narrow proxies to them
COUNTRIES_JSON=$(curl -s "https://raxyproxy.com/api/v1/locations/cities?pool_type=residential&countries=us" \
                  -H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx")
TOP=$(echo "$COUNTRIES_JSON" | jq -r '.data.items | sort_by(-.count) | .[0:5] | map(.code) | join(",")')
curl "https://raxyproxy.com/api/v1/packages/12/proxies?quantity=50&countries=us&cities=$TOP" \
     -H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
locations.py
import requests

API_KEY = 'raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
HEADERS = {'Authorization': f'Bearer {API_KEY}'}

# What countries can I currently target on residential?
r = requests.get(
    'https://raxyproxy.com/api/v1/locations/countries',
    headers=HEADERS,
    params={'pool_type': 'residential'},
).json()

for item in r['data']['items']:
    print(f"{item['code']}  {item['name']:25}  pool={item['count']:,}")
← السابق
Stats — Errors
التالي →
مفاتيح API