Perform Country Targeting

Execute a geo-targeting request using proxy credentials.

How to Specify Country

If you need to geo-target requests at the country level, simply append -country-<country_code> after the <geonode_username>.

Example curl request

cURL

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

200

{
  "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"
}

Response

200

application/json

Successful response from Geo-Targeting API.

status · string

Indicates the status of the request.

Example:

"success"

continent · string

The name of the continent.

Example:

"North America"

continentCode · string

The two-letter continent code.

Example:

"NA"

country · string

The full name of the country.

Example:

"Canada"

countryCode · string

The two-letter country code.

Example:

"CA"

region · string

The region code.

Example:

"QC"

regionName · string

The full name of the region.

Example:

"Quebec"

city · string

The name of the city.

Example:

"Montreal"

district · string

The district name, if available.

Example:

""

zip · string

The postal code associated with the IP.

Example:

"H2Y"

lat · number

The latitude coordinate.

Example:

45.5088

lon · number

The longitude coordinate.

Example:

-73.5878

timezone · string

The timezone of the IP location.

Example:

"America/Toronto"

offset · integer

The time offset in seconds from UTC.

Example:

-18000

currency · string

The currency code of the country.

Example:

"CAD"

isp · string

The name of the Internet Service Provider.

Example:

"Bell Canada"

org · string

The organization that owns the IP address, if available.

Example:

"Bell Canada"

as · string

The Autonomous System (AS) number.

Example:

"AS577 Bell Canada"

query · string

The queried IP address.

Example:

"207.134.47.124"