Retrieve Available Geo-locations

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

Supported Service Types

This endpoint supports the following proxy services:

Service Type	Description
`PREMIUM-RESIDENTIAL`	Premium residential proxies
`ROTATING-DATACENTER`	Rotating datacenter proxies
`UNLIMITED-RESIDENTIAL`	Unlimited residential proxies

Replace the service type in the request URL with the one you want to query.

Request

Premium Residential

curl -X GET "https://monitor.geonode.com/services/PREMIUM-RESIDENTIAL/targeting-options" \
     -u geonode_username:password

Rotating Datacenter

curl -X GET "https://monitor.geonode.com/services/ROTATING-DATACENTER/targeting-options" \
     -u geonode_username:password

Unlimited Residential

curl -X GET "https://monitor.geonode.com/services/UNLIMITED-RESIDENTIAL/targeting-options" \
     -u geonode_username:password

Response

200 Success

Returns the available geo-targeting options for the selected proxy service.

Response Structure

The response is an array of country objects.

Field	Type	Description
`code`	string	ISO 3166-1 alpha-2 country code
`name`	string	Full country name
`cities`	object	Available city-level targeting options
`cities.prefix`	string	Prefix used for city targeting (for example, `-city-`)
`cities.options`	array	Available cities
`states`	object	Available state-level targeting options
`states.prefix`	string	Prefix used for state targeting (for example, `-state-`)
`states.options`	array	Available states
`asns`	object	Available ASN-level targeting options
`asns.prefix`	string	Prefix used for ASN targeting (for example, `-asn-`)
`asns.options`	array	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"
        }
      ]
    }
  }
]

Retrieve Available Geo-locations

On this page