Retrieve Available Geo-locations

Retrieve a comprehensive list of all available geo-locations, including countries, cities, states, and ASNs that you can use for geo-targeting your proxy requests.

Request

curl -X GET "https://monitor.geonode.com/services/locations/proxies" \
     -u geonode_username:password

Response

200 Success

List of available geo-locations retrieved successfully.

Response Structure

The response is an array of country objects, each containing:

Field	Type	Description
`code`	string	ISO 3166-1 alpha-2 country code
`name`	string	Full country name
`cities`	object	City-level targeting options
`cities.prefix`	string	Prefix to use for city targeting (e.g., "-city-")
`cities.options`	array	List of available cities
`states`	object	State-level targeting options
`states.prefix`	string	Prefix to use for state targeting (e.g., "-state-")
`states.options`	array	List of available states
`asns`	object	ASN-level targeting options
`asns.prefix`	string	Prefix to use for ASN targeting (e.g., "-asn-")
`asns.options`	array	List of available ASNs

Example Response

[
  {
    "code": "AF",
    "name": "Afghanistan",
    "cities": {
      "prefix": "-city-",
      "options": [
        {
          "code": "kabul",
          "name": "Kabul"
        }
      ]
    },
    "states": {
      "prefix": "-state-",
      "options": [
        {
          "code": "kabul",
          "name": "Kabul"
        }
      ]
    },
    "asns": {
      "prefix": "-asn-",
      "options": [
        {
          "code": "131284",
          "name": "AS131284 Etisalat Afghan"
        }
      ]
    }
  }
]