Product Manuals and Documentation
IP Requests
IP Requests
This endpoint retrieves the IP metadata for a given IP
GeoPlugin uses API keys to allow access to the API. You can register a new GeoPlugin API key at our Developer Dashboard.
GeoPlugin expects for the API key to be included in all API requests to the server in a header that looks like the following:
You must replace YOUR_API_KEY_HERE with your personal API key.
Query Parameters
| Parameter | Description |
|---|---|
| ip | A valid IPv4 address |
| auth | Your API key you’ve retrieved from your account dashboard |
The above command returns JSON structured like this:
{
"geoplugin_request": "8.8.8.8",
"geoplugin_status": "200",
"geoplugin_credit": "Some of the returned data includes GeoLite2 data created by MaxMind, available from https://www.maxmind.com.",
"geoplugin_region": null,
"geoplugin_areaCode": null,
"geoplugin_dmaCode": null,
"geoplugin_countryName": "United States",
"geoplugin_countryCode": "US",
"geoplugin_euVATrate": null,
"geoplugin_continentName": "North America",
"geoplugin_inEU": "null",
"geoplugin_continentCode": "NA",
"geoplugin_city": null,
"geoplugin_regionName": null,
"geoplugin_regionCode": null,
"geoplugin_longitude": -97.822,
"geoplugin_latitude": 37.751,
"geoplugin_locationAccuracyRadius": null,
"geoplugin_timezone": "America/Chicago",
"geoplugin_currencyCode": USD,
"geoplugin_currencySymbol": null,
"geoplugin_currencyConverter": null,
"geoplugin_currencySymbol_UTF8": null,
"languages": "[ "en-US", "es-US", haw, "fr"]
}
Multi-lingual results
Multi-lingual results
This endpoint retrieves the IP metadata for a given IP. If you pass in a a “lang” param with a valid iso eg. “en”, “fr”, “it”, “de”. Language will fallback to English when your chosen language is unavailable.
Full list of valid languages: see here:
IP Find uses API keys to allow access to the API. You can register a new IP Find API key at our Developer Dashboard
IP Find expects for the API key to be included in all API requests to the server in a header that looks like the following:
You must replace YOUR_API_KEY_HERE with your personal API key.
The above command with lang specified as “hi” returns JSON in Hindi structured like this.
If a name can’t be found with this language it will fall back to English
{
"geoplugin_request": "203.122.35.1",
"geoplugin_status": "200",
"geoplugin_credit": "Some of the returned data includes GeoLite2 data created by MaxMind, available from https://www.maxmind.com.",
"geoplugin_region": "दिल्ली",
"geoplugin_areaCode": null,
"geoplugin_dmaCode": null,
"geoplugin_countryName": "भारत",
"geoplugin_countryCode": "IN",
"geoplugin_euVATrate": null,
"geoplugin_continentName": "एशिया महाद्वीप",
"geoplugin_inEU": "null",
"geoplugin_continentCode": "AS",
"geoplugin_city": "नई दिल्ली",
"geoplugin_regionName": "दिल्ली",
"geoplugin_regionCode": "07",
"geoplugin_postal_code": "110020",
"geoplugin_longitude": 77.1663,
"geoplugin_latitude": 28.652,
"geoplugin_locationAccuracyRadius": null,
"geoplugin_timezone": "Asia/Kolkata",
"geoplugin_currencyCode": INR,
"geoplugin_currencySymbol": null,
"geoplugin_currencyConverter": null,
"geoplugin_currencySymbol_UTF8": null,
"languages": "[
"en-IN",
"hi",
"bn",
"te",
"mr",
"ta",
"ur",
"gu",
"kn",
"ml",
"or",
"pa",
"as",
"bh",
"sat",
"ks",
"ne",
"sd",
"kok",
"doi",
"mni",
"sit",
"sa",
"fr",
"lus",
"inc"
]"}
Get the Current User or client’s IP Location
Get the Current User or client’s IP Location
| Parameter | Description |
|---|---|
| ip | A valid IPv4 address |
| auth | Your API key you’ve retrieved from your account dashboard |
The above command returns the meta data for the IP address of the request client: eg.
{
"geoplugin_request": "8.8.8.8",
"geoplugin_status": "200",
"geoplugin_credit": "Some of the returned data includes GeoLite2 data created by MaxMind, available from https://www.maxmind.com.",
"geoplugin_region": null,
"geoplugin_areaCode": null,
"geoplugin_dmaCode": null,
"geoplugin_countryName": "United States",
"geoplugin_countryCode": "US",
"geoplugin_euVATrate": null,
"geoplugin_continentName": "North America",
"geoplugin_inEU": "null",
"geoplugin_continentCode": "NA",
"geoplugin_city": null,
"geoplugin_regionName": null,
"geoplugin_regionCode": null,
"geoplugin_longitude": -97.822,
"geoplugin_latitude": 37.751,
"geoplugin_locationAccuracyRadius": null,
"geoplugin_timezone": "America/Chicago",
"geoplugin_currencyCode": USD,
"geoplugin_currencySymbol": null,
"geoplugin_currencyConverter": null,
"geoplugin_currencySymbol_UTF8": null,
"languages": "[ "en-US", "es-US", haw, "fr"]
}
Get a country flag from an IP address
Get a country flag from an IP address
Query Parameters
| Parameter | Description |
|---|---|
| ip | A valid IPv4 address |
| auth | Your API key you’ve retrieved from your account dashboard |
The above command redirects to an image like this: https://api.geoplugin.com/flag/64/us.png