
IP Geolocation API connects your WordPress site to a free IP geolocation API and puts the results anywhere on your site: posts, pages, sidebars, or your own code.
Every lookup returns country, region, city, postal code, latitude and longitude, ASN, ISP or organization, timezone, local currency, EU membership, and VPN, proxy, and Tor signals.
https://github.com/thebigasif/ipgeolocation-wordpress
Front end
- Shortcode: [ipgeo_lookup] with fields, placeholder, button text, and template attributes
- Gutenberg block: IP Geolocation Lookup
- Sidebar widget with a template selector
- Five display templates: card, table, compact, raw JSON, map
- Map display via OpenStreetMap or Google Maps
Developer tools
- REST API endpoints under /wp-json/ipgeo/v1/
- WP-CLI commands: wp ipgeo lookup, wp ipgeo stats, wp ipgeo bulk, wp ipgeo rules, wp ipgeo cache
- Server-side response caching with configurable TTL
- Optional API key gate for the REST endpoints
- Bulk CSV lookup: upload a list of IPs or domains, download the enriched results
Automation
- Visitor geolocation detection
- Geolocation content rules: show content, redirect, set headers, or run shortcodes based on the visitor country, region, city, timezone, currency, ASN, VPN or proxy status, and EU membership
- Lookup statistics dashboard with daily totals
- Privacy mode to disable all logging
- Full data cleanup on uninstall
Free tier
Basic lookups need no account and no API key. A free key from ipgeolocationapi.io raises the daily quota to 5,000 lookups.
External Services
This plugin calls third-party services:
- IPGeolocationAPI.io (IP geolocation and threat data): Terms of Service and Privacy Policy
- OpenStreetMap (optional map embeds): Terms and Privacy Policy
- Google Maps (optional map embeds): Terms and Privacy Policy
External services
This plugin sends IP addresses to the IP Geolocation API service (https://ipgeolocationapi.io) to retrieve geolocation data. Its Terms of Service (https://ipgeolocationapi.io/terms) and Privacy Policy (https://ipgeolocationapi.io/privacy) apply.
The map template can embed maps from OpenStreetMap (https://www.openstreetmap.org/copyright and https://wiki.osmfoundation.org/wiki/Privacy_Policy) or Google Maps (https://policies.google.com/terms and https://policies.google.com/privacy), depending on your settings.