🌍

GeoIP Worker

Give it an IP, get back the country name and flag emoji. A zero-dependency, deploy-anywhere Cloudflare Worker.

⚡ Try It Now 🔍 View API

🔍 Try It Live

Enter an IP address below to look up its country and flag.

Enter an IP and tap Lookup

📡 API Endpoint

One endpoint. One parameter. That's it.

GET /?ip=45.196.201.208

→ { "name": "Philippines", "flag": "🇵🇭" }

⚡ Quick Start

curl https://geoip.mobileahmad43-a18.workers.dev/?ip=8.8.8.8

Returns: {"name":"United States","flag":"🇺🇸"}

✨ Features

  • Free to use — powered by ip-api.com free tier
  • 24-hour in-memory cache for fast repeat lookups
  • Full CORS support — use it from any web app
  • Zero configuration — deploy and go
  • ~500 bytes — tiny footprint

🔧 Deploy Your Own

git clone <repo>
cd geoip-worker
npx wrangler deploy

No API keys, no secrets, no configuration needed.