IP Locator — Suburb & Country

Python tool that turns IPs into suburb & country via ip-api.com + OpenStreetMap Nominatim. Live lookups only.

I can customise for specific datasets or formats — hire me on Upwork: https://www.upwork.com/freelancers/ericfisher

---

Features

• Reads a CSV with an IP column (auto-detected)
• Outputs: ip,suburb,country
• Respects free-tier API rate limits
• Works on Windows, macOS, and Linux

Install

pip install -r requirements.txt

Usage (Windows example)

python ip_locator_live.py --in "IP_sample__10_rows_.csv" --out "output.csv" --verbose

This processes the included IP_sample__10_rows_.csv and writes output.csv with suburb + country lookups.

Included files

• ip_locator_live.py — The main script
• IP_sample__10_rows_.csv — Sample input file
• output.csv — Example output generated from the sample input
• requirements.txt — Dependencies for running the script

Notes

• Private/reserved IPs will return blank suburb/country
• Suburb is taken from OpenStreetMap reverse geocoding (falls back to city if needed)
• I can adapt this script for different data sources, output formats, or API providers