Country-level geo lookup as a service. Cloudflare-edge fast, DB-IP-backed. Designed to power WordPress plugins (country pricing, geo redirect, GDPR consent) without per-site MaxMind license keys or manual database updates.
| Method | Path | Auth | Purpose |
|---|---|---|---|
| GET | /v1/me | none | Caller's geo from Cloudflare edge data |
| GET | /v1/country?ip=... | API key | Country lookup for any IP |
| GET | /v1/lookup?ip=... | API key | Full geo lookup (city, region, ASN) |
| POST | /v1/lookup | API key | Batch lookup (max 100 IPs) |
| GET | /v1/usage | API key | Your usage stats |
Your geo, right now (no auth needed):
curl https://api.geomind.au/v1/me
Authenticated lookup:
curl -H "Authorization: Bearer gm_live_..." \
"https://api.geomind.au/v1/lookup?ip=8.8.8.8"
Every endpoint returns the same Geo object:
{
"ip": "8.8.8.8",
"country": "US",
"countryName": "United States",
"continent": "NA",
"inEU": false,
"currency": "USD",
"city": "Mountain View",
"region": "California",
"regionCode": "CA",
"timezone": "America/Los_Angeles",
"asn": 15169,
"asOrganization": "Google LLC",
"source": "d1",
"lookedUpAt": "2026-05-03T00:04:28Z"
}
Two plugins consume this API:
Both are part of the JezPress plugin catalogue. API keys are auto-provisioned during plugin activation.
Currently invite-only for Jezweb clients and JezPress-licensed sites. Contact support@jezweb.com.au for early access.