Default geo (pool parameters)

Persist a default geo and behaviour profile so /proxies returns geo-targeted credentials without you passing query params every time.

GET /packages/{id}/default-geo

Returns the currently persisted default pool parameters for the package — countries, states, cities, ZIP codes, ASNs, exclude lists, anonymous filter, and rotation interval.

GET/api/v1/packages/{id}/default-geo

response.json

{
  "data": {
    "countries":         ["us", "gb"],
    "states":            [],
    "cities":            [],
    "zipcodes":          [],
    "asns":              [],
    "exclude_countries": ["cn", "ru"],
    "exclude_asn":       [],
    "anonymous_filter":  true,
    "rotation_interval": 30
  },
  "meta": { "version": "v1" }
}

PUT /packages/{id}/default-geo

Persist a new default. PUT semantics: the body fully replaces the previous configuration — fields you omit revert to empty/false/null.

Persistent geo is provider-resolved

Persisted default geo is enforced by the upstream proxy provider at connection time. Per-request query parameters on /packages/{id}/proxies still override the default. The 2× traffic surcharge for state/city/zip/ASN targeting applies to the same pool types as the per-request variant.

PUT/api/v1/packages/{id}/default-geo

request.json

{
  "countries":         ["us"],
  "states":            ["california"],
  "exclude_countries": [],
  "anonymous_filter":  true,
  "rotation_interval": 60
}

Code examples

default-geo.sh

# Inspect current default
curl https://raxyproxy.com/api/v1/packages/12/default-geo \
     -H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# Replace: pin to US, exclude CN/RU, anonymous-only, 60-min rotation
curl -X PUT https://raxyproxy.com/api/v1/packages/12/default-geo \
     -H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
     -H "Content-Type: application/json" \
     -d '{"countries":["us"],"exclude_countries":["cn","ru"],"anonymous_filter":true,"rotation_interval":60}'

# Clear (revert to rotating worldwide)
curl -X PUT https://raxyproxy.com/api/v1/packages/12/default-geo \
     -H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
     -H "Content-Type: application/json" \
     -d '{}'

← Previous

Blocked Hosts

Top-up