geoPlugin Home

XML Geolocation Web Service

The XML Geolocation web service API 1) allows you to directly program your back-end scripts to deliver dynamic geo-localized pages using the XML elements provided by geoPlugin.

To access this service, add the following url to a remote include call

Of course, substitute the xx's with your visitor's IP number.

Example output of an XML query for your IP address ( is:

<?xml version="1.0" encoding="UTF-8"?>
	<geoplugin_credit>Some of the returned data includes GeoLite data created by MaxMind, available from <a href=''></a>.</geoplugin_credit>
	<geoplugin_countryName>United States</geoplugin_countryName>
	<geoplugin_continentName>North America</geoplugin_continentName>

XML Geolocation Currency Converter

The “geoplugin_currencyConverter” element is the conversion rate for the currency converter base currency.
Like all calls to any of geoPlugin's web services, the default base_currency is USD ($US).
Thus, if your base currency is NOT $US, then you must add the variable base_currency=XXX to the call to

Now the geoplugin_currencyConverter element will output the exchange rate of one Euro for your visitor.

The base_currency value must be a valid ISO 4217 3-letter code.

See also

1) This product includes GeoLite data created by MaxMind, available from

Acceptable Use Policy    Privacy Policy and User Agreement    Contact geoPlugin

©2006 - 2020 geoPlugin® is a registered trademark of GEOPLUGIN, SAS