Perform Country Targeting

Execute a geo-targeting request to route proxy traffic through a specific country.

Route your proxy requests through a specific country by including the country code in your username string.

How to Specify Country

Append -country-<country_code> after your <geonode_username> to target a specific country.

For example: username-country-US targets the United States.

Request

curl --request GET \
     -x "http://proxy.geonode.io:<port>" \
     --user "<geonode_username>-country-<country_code>:<geonode_password>" \
     --url "http://ip-api.com/json"

Response

200 Success

Returns detailed geolocation information about the IP address assigned to your proxy connection.

Response Fields

Field	Type	Description
`status`	string	The status of the request (e.g., "success")
`continent`	string	The name of the continent
`continentCode`	string	The two-letter continent code
`country`	string	The full name of the country
`countryCode`	string	The two-letter country code (ISO 3166-1 alpha-2)
`region`	string	The region code
`regionName`	string	The full name of the region
`city`	string	The name of the city
`district`	string	The district name, if available
`zip`	string	The postal code associated with the IP
`lat`	number	The latitude coordinate
`lon`	number	The longitude coordinate
`timezone`	string	The timezone of the IP location
`offset`	integer	The time offset in seconds from UTC
`currency`	string	The currency code of the country
`isp`	string	The name of the Internet Service Provider
`org`	string	The organization that owns the IP address
`as`	string	The Autonomous System (AS) number
`query`	string	The queried IP address

Example Response

{
  "status": "success",
  "continent": "North America",
  "continentCode": "NA",
  "country": "Canada",
  "countryCode": "CA",
  "region": "QC",
  "regionName": "Quebec",
  "city": "Montreal",
  "district": "",
  "zip": "H2Y",
  "lat": 45.5088,
  "lon": -73.5878,
  "timezone": "America/Toronto",
  "offset": -18000,
  "currency": "CAD",
  "isp": "Bell Canada",
  "org": "Bell Canada",
  "as": "AS577 Bell Canada",
  "query": "207.134.47.124"
}