🌐 IP Geolocation Scraper

🚀 Bulk-geolocate IPv4 and IPv6 addresses in seconds. Pull 26 fields per IP including city, country, lat/lng, timezone, ASN, organization, currency, and calling code. Pass a list of IPs, get a clean dataset. No login, no per-IP curl scripts.

🕒 Last updated: 2026-05-22 · 📊 26 fields per record · 🌍 250+ countries · 🔢 IPv4 + IPv6 · 🧭 ip-api feed with automatic fallback

The IP Geolocation Scraper turns a list of IPv4 or IPv6 addresses into a clean dataset and returns 26 fields per record, including city, region and region code, country name with ISO 2 and ISO 3 codes, capital, country TLD, continent, EU membership flag, postal code, latitude and longitude, timezone with UTC offset, calling code, currency, currency name, languages, country area and population, ASN, and the registered organization. The underlying source is the ip-api lookup feed with automatic freeipapi fallback for resilience.

The dataset spans every country and territory with assigned IP allocations, both IPv4 and IPv6, and surfaces both geographic and network-layer attributes in one record. This Actor turns a list of IPs into a downloadable dataset as CSV, Excel, JSON, or XML in under five minutes.

🎯 Target Audience	💡 Primary Use Cases
Security operations, fraud-detection teams, product analytics, IT operations, compliance, marketing localization	Threat enrichment, account-takeover scoring, region-aware feature gating, log enrichment, GDPR routing, CDN performance analysis

---

📋 What the IP Geolocation Scraper does

A single bulk-lookup workflow with two main inputs:

• 📝 IP list. Pass IPv4 or IPv6 addresses in any quantity.
• 🎯 Field projection. Optional. Pick which of the 26 fields each record should carry.

Each record bundles network layer (IP, version, ASN, organization), geography (city, region, country, postal, lat/lng, continent, EU membership), timekeeping (timezone, UTC offset), and country reference data (capital, TLD, currency, languages, area, population, calling code).

💡 Why it matters: every security event log, signup form, and ad-bid request needs to know where an IP comes from. Building a private geolocation service means licensing MaxMind, hand-rolling fallbacks, and updating database files weekly. This Actor returns enriched records in a single run.

---

🎬 Full Demo

🚧 Coming soon: a 3-minute walkthrough showing how to go from sign-up to a downloaded dataset.

---

⚙️ Input

Input	Type	Default	Behavior
maxItems	integer	10	Records to return. Free plan caps at 10, paid plan at 1,000,000.
ips	array	["8.8.8.8", "1.1.1.1", "208.67.222.222", "9.9.9.9", "4.2.2.1"]	IPv4 or IPv6 addresses to geolocate.
fields	array	[]	Optional projection of the 26 source fields. Empty returns the full record.

Example: geolocate five public DNS resolvers.

{
    "maxItems": 5,
    "ips": ["8.8.8.8", "1.1.1.1", "208.67.222.222", "9.9.9.9", "4.2.2.1"]
}

Example: minimal record with only city and country.

{
    "maxItems": 100,
    "ips": ["8.8.8.8", "1.1.1.1"],
    "fields": ["ip", "city", "country_name", "country_code"]
}

⚠️ Good to Know: IP geolocation is approximate. City-level results are typically accurate to within a metro area for residential IPs and to a country for mobile or carrier-grade NAT. For high-stakes fraud decisions, combine with device fingerprinting and behavioral signals. Reserved, private, and bogon IPs return diagnostic records.

---

📊 Output

Each record contains 26 fields. Download the dataset as CSV, Excel, JSON, or XML.

🧾 Schema

Field	Type	Example
🌐 ip	string	"8.8.8.8"
🔢 version	string	"IPv4"
🏙️ city	string	"Mountain View"
🗺️ region	string	"California"
🆔 regionCode	string	"CA"
🏳️ countryName	string	"United States"
🆔 countryCode	string	"US"
🆔 countryCodeIso3	string	"USA"
🏛️ countryCapital	string	"Washington"
🌐 countryTld	string	".us"
🌎 continentCode	string	"NA"
🇪🇺 inEu	boolean	false
📮 postal	string	"94043"
📍 latitude	number	37.4056
📍 longitude	number	-122.0775
🕒 timezone	string	"America/Los_Angeles"
⏱️ utcOffset	string	"-0700"
☎️ countryCallingCode	string	"+1"
💱 currency	string	"USD"
💱 currencyName	string	"Dollar"
🗣️ languages	string	"en-US,es-US,haw,fr"
📐 countryArea	number	9629091
👥 countryPopulation	number	331002651
🔢 asn	string	"AS15169"
🏢 org	string	"GOOGLE"
🕒 scrapedAt	ISO 8601	"2026-05-22T00:00:00.000Z"
⚠️ error	string | null	null

📦 Sample records

---

✨ Why choose this Actor

	Capability
🌐	IPv4 and IPv6 ready. One bulk lookup for both address families.
🔢	Network-layer fields. ASN and registered organization included on every record, not just geography.
🌍	Country reference bundled. Capital, TLD, currency, languages, area, and population shipped with every IP.
🛡️	Automatic fallback. Primary feed is ip-api, with freeipapi as backup if the primary trips a transient limit.
🎯	Field projection. Trim each record to just the columns your dashboard needs.
⚡	Bulk friendly. Pass hundreds or thousands of IPs in one input array.
🚫	No authentication. Public geolocation feeds. No API key, no token.

📊 IP geolocation is the foundation of fraud scoring, region-aware product flows, and infrastructure analytics. Doing it well at scale is harder than it looks.

---

📈 How it compares to alternatives

Approach	Cost	Coverage	Refresh	Fallback	Setup
⭐ IP Geolocation Scraper (this Actor)	$5 free credit, then pay-per-use	IPv4 + IPv6 worldwide	Live per run	freeipapi fallback built in	⚡ 2 min
MaxMind GeoIP2 database	$50+/month	Excellent	Weekly file pull	None	⏳ Hours
Per-IP curl scripts	Free	Whatever the feed offers	Live	None	🕒 Days
Commercial geolocation feeds	$500+/month	Global, high accuracy	Real-time	Vendor SLA	⏳ Hours

Pick this Actor when you want bulk lookups, network-layer attributes, and zero database maintenance.

---

🚀 How to use

1. 📝 Sign up. Create a free account with $5 credit (takes 2 minutes).
2. 🌐 Open the Actor. Go to the IP Geolocation Scraper page on the Apify Store.
3. 🎯 Set input. Paste a list of IPs into the ips array and set maxItems.
4. 🚀 Run it. Click Start and let the Actor collect your dataset.
5. 📥 Download. Grab results in the Dataset tab as CSV, Excel, JSON, or XML.

⏱️ Total time from signup to downloaded dataset: 3-5 minutes. No coding required.

---

💼 Business use cases

🛡️ Security & Fraud Enrich SIEM events with geo and ASN context Score account-takeover risk by country mismatch Flag VPN, hosting, and Tor exit nodes via ASN lookup Build allow/deny rules by region for sensitive endpoints	📊 Product Analytics Region-split funnel metrics by IP Localize pricing by detected country and currency Power A/B test geo-segments with verified data Build country-of-origin charts for executive dashboards
🖥️ IT Operations Map customer support tickets to data centers Audit firewall logs with ASN and org context Reverse-lookup outbound IPs in deploy scripts Track CDN edge usage with city-level granularity	⚖️ Compliance & Privacy GDPR routing based on EU-resident flag Geo-block subscribers per regulator request Document data-residency decisions with citations Audit cross-border data flows in security reviews

---

🔌 Automating IP Geolocation Scraper

Control the scraper programmatically for scheduled runs and pipeline integrations:

• 🟢 Node.js. Install the apify-client NPM package.
• 🐍 Python. Use the apify-client PyPI package.
• 📚 See the Apify API documentation for full details.

The Apify Schedules feature lets you trigger this Actor on any cron interval. Daily enrichment jobs against a watched IP list keep your downstream tables fresh without manual work.

---

🌟 Beyond business use cases

IP data powers more than commercial workflows. The same records support research, education, civic projects, and personal initiatives.

🎓 Research and academia Network measurement studies and ASN analyses Coursework on Internet topology and routing Reproducible measurement studies with cited dataset pulls Open-data exercises on global infrastructure	🎨 Personal and creative Visualize visitors on a personal blog dashboard Hobby projects on home-network logging Side projects on global Internet weather maps Curated lists of public DNS resolvers and their locations
🤝 Non-profit and civic Public-interest tooling on Internet shutdown tracking Civic transparency around content blocking by region Investigative journalism on disinformation infrastructure Open-knowledge contributions to network research	🧪 Experimentation Train geo-aware recommender systems Validate localization hypotheses with real IPs Prototype agent pipelines that enrich logs Seed analytics warehouses with realistic geo features

---

🤖 Ask an AI assistant about this scraper

Open a ready-to-send prompt about this ParseForge actor in the AI of your choice:

• 💬 ChatGPT
• 🧠 Claude
• 🔍 Perplexity
• 🅒 Copilot

---

❓ Frequently Asked Questions

🧩 How does it work?

Pass a list of IPv4 or IPv6 addresses, click Start, and the Actor returns one structured record per IP. Each record carries city, country, ASN, organization, and country reference fields like currency and calling code.

📏 How accurate is the geolocation?

City-level results are typically accurate to within a metro area for residential and corporate IPs. Mobile and carrier-grade NAT IPs may resolve only to country level. For high-stakes fraud or compliance decisions, combine with device fingerprinting and behavioral signals.

🛡️ What happens if the primary feed rate-limits a request?

The Actor automatically falls back to a secondary geolocation feed (freeipapi) so your dataset stays complete. If both feeds fail for a given IP, that record carries an explicit error message.

🔢 Does it support IPv6?

Yes. Both IPv4 and IPv6 addresses are supported in the same input array. The version field on each record tells you which family was looked up.

🚫 What about private or reserved IPs?

Reserved, private, and bogon ranges return diagnostic records rather than fake geo data. Filter them out before enriching public logs.

☎️ Why include calling code, currency, and languages?

Because most teams that enrich an IP also want to localize the experience. Bundling country reference fields means one Actor instead of two, and clean joins for region-aware UX.

💼 Can I use this data commercially?

Yes. The underlying feeds permit commercial use within their terms. Review the source feed terms for your specific use case, especially for high-volume real-time scoring.

💳 Do I need a paid Apify plan to use this Actor?

No. The free Apify plan is enough for testing and small pulls (10 records per run). A paid plan lifts the limit and gives you access to scheduling, higher concurrency, and larger datasets.

🔁 What happens if a run fails or gets interrupted?

Apify automatically retries transient errors. If a run still fails, inspect the log in the Runs tab, fix the input, and re-run. Partial datasets from failed runs are preserved so you never lose progress.

🔁 How often does the geolocation database update?

The upstream feeds update continuously as ASN assignments and BGP advertisements change. Every run of this Actor reads the live feed so your results reflect the current state of the routing table.

🆘 What if I need help?

Our support team is here to help. Contact us through the Apify platform or use the Tally form linked below.

---

🔌 Integrate with any app

IP Geolocation Scraper connects to any cloud service via Apify integrations:

• Make - Automate multi-step workflows
• Zapier - Connect with 5,000+ apps
• Slack - Get run notifications in your channels
• Airbyte - Pipe geolocation records into your warehouse
• GitHub - Trigger runs from commits and releases
• Google Drive - Export datasets straight to Sheets

You can also use webhooks to trigger downstream actions when a run finishes. Push fresh geo enrichment into your SIEM, or alert your fraud team in Slack when a watched IP changes country.

---

🔗 Recommended Actors

• 🌍 REST Countries Info Scraper - 250+ countries with population, currencies, languages
• 🐙 GitHub Status History Scraper - GitHub uptime, incidents, and component history
• 🗺️ Nominatim OSM Scraper - Geocode addresses via OpenStreetMap
• ✈️ OurAirports Scraper - 85,000+ airports, heliports, and airfields worldwide
• 📚 Internet Archive Search Scraper - 50M+ archived texts, audio, video, software

💡 Pro Tip: browse the complete ParseForge collection for more developer-tools scrapers.

---

🆘 Need Help? Open our contact form to request a new scraper, propose a custom data project, or report an issue.

---

⚠️ Disclaimer: this Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by ip-api, freeipapi, or any of their contributors. All trademarks mentioned are the property of their respective owners. Only publicly available geolocation data is collected.