Product Manuals and Documentation

IP Requests

IP Requests

GET https://api.geoplugin.com/?ip=X.X.X.X&auth=YOUR_API_KEY_HERE

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
GET https://api.geoplugin.com/?ip=X.X.X.X&auth=YOUR_API_KEY_HERE&lang=XX

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


GET https://api.geoplugin.com?ip=X.X.X.X&auth=YOUR_API_KEY_HERE&lang=XX

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:

Selected ISO Name will appear 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.


GET https://api.geoplugin.com/?ip=X.X.X.X&auth=YOUR_API_KEY_HERE&lang=XX

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


GET https://api.geoplugin.com/?ip=X.X.X.X&auth=YOUR_API_KEY_HERE&lang=XX
Parameter Description
ip A valid IPv4 address
auth Your API key you’ve retrieved from your account dashboard

CURL" https://api.geoplugin.com/me?auth=YOUR_API_KEY_HERE"

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


GET https://api.geoplugin.com/flag?ip=X.X.X.X&auth=YOUR_API_KEY_HERE

Query Parameters

Parameter Description
ip A valid IPv4 address
auth Your API key you’ve retrieved from your account dashboard

CURL" https://api.geoplugin.com/flag?ip=8.8.8.8&auth=YOUR_API_KEY_HERE"

The above command redirects to an image like this: https://api.geoplugin.com/flag/64/us.png