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