Standort-Discovery

Verfügbare Länder, Staaten, Städte, PLZ und ASNs pro Pool-Typ nachschlagen — so bauen Sie Geo-Filter aus echten Daten statt zu raten.

Alle Standort-Endpunkte akzeptieren einen erforderlichen pool_type-Parameter und liefern Arrays von {code, name, count}. Code-Werte direkt mit /packages/{id}/proxies und /default-geo verwenden. 1h API-Cache + längere Upstream-Caches — Änderungen im Provider-Katalog landen binnen Minuten.

GET /locations/countries

Gibt verfügbare Länder für den gewählten Pool zurück. Kein Filter erforderlich.

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

Gibt Staaten innerhalb der angegebenen Länder zurück.

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

GET /locations/cities

Gibt Städte innerhalb der angegebenen Länder zurück (optional auf Staaten eingegrenzt).

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

GET /locations/zipcodes

Gibt PLZ innerhalb der angegebenen Länder zurück (optional auf Staaten eingegrenzt).

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

GET /locations/asns

Gibt ASNs innerhalb der angegebenen Länder zurück (optional auf Staaten/Städte eingegrenzt).

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

Code-Format

Länder: 2-stellige ISO-Codes in Kleinbuchstaben (us, gb, de). Staaten und Städte: volle Namen, Kleinbuchstaben, ohne Leerzeichen — z. B. california, newyork, sanfrancisco. PLZ: numerische Strings. ASNs: numerisch, ohne AS-Präfix.

Code-Beispiele

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']:,}")