Exclude targeting

Exclude city

Exclude specific cities when assigning a proxy IP. This is a username flag on the proxy connection (proxy.geonode.io), not a separate HTTP management API.

Auth

Use your Geonode proxy username and password with the proxy URL.

Username syntax

FormExample username suffix
Single city-not.city-charlotte
Multiple cities-not.city-charlotte,newyork,houston
City exclusion inside a country-country-US-not.city-charlotte,newyork

Full proxy user string shape (with country targeting):

<geonode_username>-country-<COUNTRY>-not.city-<city>[,<city>...]:<geonode_password>

City values are lowercase names without spaces (for example charlotte, newyork).

Rules

  • Use only one exclusion type per request. Do not combine -not.city- with -not.country-, -not.state-, or -not.asn-.
  • You can combine positive -country- targeting with -not.city-.

Parameters

NameInRequiredDescription
geonode_usernameproxy useryesDashboard proxy username (before flags)
geonode_passwordproxy useryesDashboard proxy password
countryusername flagrecommendedISO country code to scope routing (for example US)
not.cityusername flagyesComma-separated city names to exclude
portproxy URLyesProxy port from your plan / dashboard

Example

curl -x "http://proxy.geonode.io:<port>" \
  --proxy-user "<geonode_username>-country-US-not.city-charlotte,houston:<geonode_password>" \
  "http://ip-api.com/json"

Response

The example URL is ip-api.com (IP check). The JSON is that service’s view of the egress IP, not a Geonode API schema.

city should not be one of the excluded cities when exclusion is applied successfully.

{
  "status": "success",
  "country": "United States",
  "countryCode": "US",
  "region": "IL",
  "regionName": "Illinois",
  "city": "Des Plaines",
  "zip": "60016",
  "lat": 42.0487,
  "lon": -87.8905,
  "timezone": "America/Chicago",
  "isp": "Comcast Cable Communications",
  "org": "Comcast IP Services, L.L.C.",
  "as": "AS7922 Comcast Cable Communications, LLC",
  "query": "73.208.181.162"
}

-country-US-not.city-charlotte returned city: "Des Plaines" (not Charlotte).

Useful fields to check: city, countryCode, query.

Was this page helpful?

On this page