State targeting

Target a state or region inside a country. This is a username flag on proxy.geonode.io, not a separate HTTP management API.

Auth

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

Username syntax

Form	Example username suffix
Country + state	`-country-US-state-texas`

<geonode_username>-country-<COUNTRY>-state-<state>:<geonode_password>

State values are lowercase without spaces (for example texas, california).

Rules

Do not combine -state- and -city- in the same request.
Always include -country- with -state-.

Parameters

Name	In	Required	Description
`geonode_username`	proxy user	yes	Dashboard proxy username
`geonode_password`	proxy user	yes	Dashboard proxy password
`country`	username flag	yes	ISO country code
`state`	username flag	yes	State / region name
`port`	proxy URL	yes	Proxy port

Example

curl -x "http://proxy.geonode.io:<port>" \
  --proxy-user "<geonode_username>-country-US-state-texas:<geonode_password>" \
  "http://ip-api.com/json"

Response

ip-api.com egress check (not a Geonode schema).

Example with -country-US-state-texas (regionName: "Texas"):

{
  "status": "success",
  "country": "United States",
  "countryCode": "US",
  "region": "TX",
  "regionName": "Texas",
  "city": "Austin",
  "zip": "78746",
  "lat": 30.2971,
  "lon": -97.8181,
  "timezone": "America/Chicago",
  "isp": "AT&T Enterprises, LLC",
  "org": "AT&T Corp",
  "as": "AS7018 AT&T Enterprises, LLC",
  "query": "76.214.113.67"
}

Useful fields: regionName, region, countryCode, query.