How It Works

Get started with GeoPlugin in just a few simple steps. No complex setup required.

Green rounded square icon with a black outline of a globe. 01

Sign Up and Get Your API Key

Create a free account and receive your API key instantly. No credit card required. Start using our geolocation services right away.

Green rounded square icon with a graph, dollar sign, and upward arrow. 02

Add One Line of Code

Copy our lightweight script and paste it into your website. Works with any platform including WordPress, Shopify, Webflow, and custom builds.

Green rounded square icon with a graph, dollar sign, and upward arrow. 03

Everything Runs Automatically

Once set up, GeoPlugin automatically detects visitor locations and personalizes their experience. Redirect visitors, switch content, and deploy popups with just a few clicks.

100K+

Active Users

1B+

API Requests/Month

99.9%

Uptime

195+

Countries Served

Capterra rating
5 star rating
Google Reviews rating
5 star rating
Trustpilot rating
5 star rating

API Documentation in your language of choice

GeoPlugin provides geolocation API in multiple programming languages, all in a single API call. No software installation required, no API key. Whether your programming language of choice is JavaScript, PHP, XML, JSON, ASP, or CSV, geoPlugin has a way to simply and efficiently geo-localize your visitors.

config.php

const requestUri = 'https://api.geoplugin.com';

const ipAddress = '8.8.8.8';

const key = 'your_api_key';

const url = `${requestUri}?ip=${ipAddress}&auth=${key}`;

fetch(url)

.then(response => response.json())

.then(data => {

const result = data;

console.log(result);

console.log(`Country: ${result.geoplugin_countryName}`);

console.log(`Timezone: ${result.geoplugin_timezone}`);

})

.catch(error => {

console.error('Error fetching data:', error);

});

config.php

$request_uri = 'https://api.geoplugin.com';

$ip_address = '8.8.8.8';

$key = 'your_api_key';

$url= $request_uri . "?ip=" . $ip_address . "&auth=" . $key;

$document= file_get_contents($url);

$result = json_decode($document);

config.php

const requestUri = 'https://api.geoplugin.com';

const ipAddress = '8.8.8.8';

const key = 'your_api_key';

const url = `${requestUri}?ip=${ipAddress}&auth=${key}`;

fetch(url)

.then(response => response.text())

.then(xml => {

const parser = new DOMParser();

const xmlDoc = parser.parseFromString(xml, "application/xml");

console.log(xmlDoc);

console.log(`Country: ${xmlDoc.getElementsByTagName("geoplugin_countryName")[0].childNodes[0].nodeValue}`);

console.log(`Timezone: ${xmlDoc.getElementsByTagName("geoplugin_timezone")[0].childNodes[0].nodeValue}`);

})

.catch(error => {

console.error('Error fetching data:', error);

});

config.php

const requestUri = 'https://api.geoplugin.com';

const ipAddress = '8.8.8.8';

const key = 'your_api_key';

const url = `${requestUri}?ip=${ipAddress}&auth=${key}`;

fetch(url)

.then(response => response.json())

.then(data => {

const result = data;

console.log(result);

console.log(`Country: ${result.geoplugin_countryName}`);

console.log(`Timezone: ${result.geoplugin_timezone}`);

})

.catch(error => {

console.error('Error fetching data:', error);

});

config.php

using System;

using System.Net.Http;

using System.Threading.Tasks;

public class Program

{

public static async Task Main(string[] args)

{

var ip = "8.8.8.8";

var authKey = "your_api_key";

var url = $"https://api.geoplugin.com?ip={ip}&auth={authKey}";

var client = new HttpClient();

client.DefaultRequestHeaders.Add("Accept", "application/json");

var response = await client.GetStringAsync(url);

Console.WriteLine(response);

}

}

config.php

using System.Net.Http;

using System.Threading.Tasks;

public class Program

{

public static async Task Main(string[] args)

{

var ip = "8.8.8.8";

var authKey = "your_api_key";

var url = $"https://api.geoplugin.com?ip={ip}&auth={authKey}";

var client = new HttpClient();

client.DefaultRequestHeaders.Add("Accept", "text/csv");

var response = await client.GetStringAsync(url);

Console.WriteLine(response);

}

}

Live API statistics

Below are our external monitors for web service uptime and internal live graphs on the lookups we handle.

Request per hour
GeoPlugin requests - By Day
Request per day
GeoPlugin requests - By Week

Geo targeting works: Try it today!

Geoplugin circuclar black icon with two upward arrows next to a person symbolizing user experience.

Enhance the visitor experience

Show location-based content for a personalized visitor experience.

Geoplugin black circular icon with a green check mark on a badge symbolizing trustworthy service.

Build trust with your audience

Create a local feel for your visitors and instantly enhance trust

Geoplugin black circular icon with a green rocket ship symbolizing boosted conversions through geotargeting.

Drastically boost conversions

Deliver location-specific offers to drive higher conversions and revenue.

Geolocation & Geo-Targeting Solutions

Everything you need to detect user location, personalize content, and optimize user experiences — all powered by fast, accurate IP geolocation technology.

Restrict or allow access to your website based on a visitor's geographic location to enhance security, compliance, and content control.

Automatically redirect visitors to the most relevant page, language, or regional version of your website based on their IP location.

Show personalized content tailored to a user's country, region, or city to increase engagement and conversion rates.

Display location-specific popups with targeted messages, offers, or alerts that resonate with users in different regions.

Create smart links that dynamically redirect users to location-specific destinations, offers, or landing pages. config.php

Add a customizable geo bar to your website to display country-specific messages, promotions, or notifications in real time.

Serve different images based on a visitor's location to localize visuals, promotions, or branding effortlessly.

Easily integrate IP-based geolocation into ASP applications with reliable and accurate location data.

Download or process geolocation data in CSV format for bulk analysis, reporting, or offline use.

Detect a visitor's local currency and convert prices automatically using accurate, up-to-date exchange rates. In the realm of web development, configuration files

Fetch geolocation data directly in the browser to personalize user experiences without server-side processing.

Access clean, lightweight geolocation data in JSON format — perfect for modern web and mobile applications.

Quickly add IP geolocation to PHP projects with simple integration and fast response times.

Securely retrieve geolocation data over HTTPS, ensuring privacy and compatibility with modern security standards.

Receive structured geolocation data in XML format for enterprise systems and legacy integrations. By following these patterns, your config

Power advanced geotargeting features such as content personalization, localization, and regional targeting with a single API.

Retrieve accurate location data including country, city, timezone, and coordinates from any IP address worldwide.

Instantly look up detailed geographic information for any IP address with high accuracy and speed.

Identify where your users are coming from and tailor your website, app, or service to their location.

Convert latitude and longitude coordinates into meaningful location details like country, region, and city.

Config.php -

In the realm of web development, configuration files play a vital role in ensuring the smooth operation of applications. One such file is config.php, a PHP script that stores and manages configuration settings for a web application. This essay aims to explore the significance, structure, and best practices associated with config.php.

✅ Is the file located outside the web root?
✅ Does it not output anything (no echo, no HTML)?
✅ Are production passwords and keys not hardcoded (using env vars instead)?
✅ Is display_errors set to 0 in production?
✅ Is there a .gitignore entry for the real config, but a tracked config.example.php?
✅ Does every page that needs config load it via require_once?


By following these patterns, your config.php becomes a clean, secure, and maintainable hub for your application's settings.


For object-oriented projects, treat configuration as a class.

<?php
// Config/Config.php
namespace App\Config;

class Config private static $settings = [];

public static function get($key, $default = null) 
    return self::$settings[$key] ?? $default;
public static function load($file) 
    self::$settings = include $file;

// Load it Config::load(DIR . '/settings.php'); $dbPassword = Config::get('db.password');

In the realm of web development, configuration files play a vital role in ensuring the smooth operation of applications. One such file is config.php, a PHP script that stores and manages configuration settings for a web application. This essay aims to explore the significance, structure, and best practices associated with config.php.

✅ Is the file located outside the web root?
✅ Does it not output anything (no echo, no HTML)?
✅ Are production passwords and keys not hardcoded (using env vars instead)?
✅ Is display_errors set to 0 in production?
✅ Is there a .gitignore entry for the real config, but a tracked config.example.php?
✅ Does every page that needs config load it via require_once?


By following these patterns, your config.php becomes a clean, secure, and maintainable hub for your application's settings.


For object-oriented projects, treat configuration as a class.

<?php
// Config/Config.php
namespace App\Config;

class Config private static $settings = [];

public static function get($key, $default = null) 
    return self::$settings[$key] ?? $default;
public static function load($file) 
    self::$settings = include $file;

// Load it Config::load(DIR . '/settings.php'); $dbPassword = Config::get('db.password');