IP Geolocation Scraper

IP Geolocation Scraper

Geolocate any IPv4 or IPv6 address in bulk, up to one million per run. Each result returns city, country, ISP, timezone, currency, and coordinates in a flat row. No API key required. Export to CSV, JSON, Excel, or XML.

Mapping IP addresses to physical locations usually means signing up for a paid API, managing keys, and dealing with rate limits. This Actor queries the public ipapi.co service directly, so you can geolocate a list of IPs without any registration. Feed it a list of IPv4 or IPv6 addresses and it returns the city, region, country, postal code, coordinates, timezone, ASN, and more for each one.

Who uses it	What they scrape ipapi for
Security analysts	Enrich firewall or access logs with geographic origin to spot anomalous traffic patterns.
Marketing teams	Segment website visitors by country or city for localized campaigns and content.
Data engineers	Batch-geocode server logs or user IPs before loading them into a data warehouse.
Fraud investigators	Check if an IP's claimed location matches its billing address or expected region.

What it does

This Actor collects geolocation data for a list of IP addresses and returns each lookup as a flat row with over 25 available fields.

• 🌍 Bulk geolocation: submit a JSON array of IPs and get one result row per address, up to a million per run.
• 📋 Field projection: pick only the fields you need (city, country, ASN, coordinates, etc.) to keep datasets lean.
• 🔄 Dual-stack support: handles both IPv4 and IPv6 addresses in the same input list.
• 📤 Multi-format export: download results as CSV, JSON, Excel, or XML directly from the dataset.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

What you can do with ipapi data

🛡️ Enrich security logs.

A SOC analyst feeds a daily export of firewall deny logs into the Actor and maps source IPs to countries, filtering for traffic from unexpected regions.

📊 Build a visitor geo-report.

A growth marketer runs a list of signup IPs through the Actor, then pivots the CSV by country to see where new users are concentrated.

🗺️ Geocode server access logs.

A data engineer schedules a weekly run that geolocates every unique IP in the CDN logs and writes the enriched dataset to a cloud bucket.

💳 Validate transaction origins.

A fraud analyst compares the IP country from a payment attempt against the card-issuing country to flag mismatches for review.

Why choose this scraper

	What you get
No API key	Queries the public ipapi.co endpoint with no registration or authentication.
Flat output	Every lookup returns one row with a fixed schema, ready for spreadsheets or databases.
Bulk scale	Process up to 1,000,000 IPs in a single run without managing pagination or retries.
Field control	Select only the columns you need to reduce dataset size and post-processing.

How it compares

No other Store actor targets ipapi the same way, so the honest comparison is with the alternatives teams actually weigh.

	IP Geolocation Scraper	Build it in-house	By hand
Setup	Run it now, zero config	Days of engineering	None, but hours per pull
When ipapi changes	Maintained for you	You fix it	You re-learn the page
Proxies, retries, anti-bot	Built in	Your problem	Browser only
Output	Fixed JSON schema, CSV/Excel export	Whatever you build	Copy-paste
Cost	Pay per result	Engineering time	Analyst hours

Configure the run

Drive the Actor with a JSON array of IP addresses and optionally restrict which fields appear in the output. The Input tab lists every parameter.

A first run with the defaults:

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

A larger pull:

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

Pricing

Pay-per-result: $0.016 per result collected. You pay only for the results written to your dataset.

Results collected	Approximate cost
100 results	$1.60
1,000 results	$16.00
10,000 results	$160.00

New Apify accounts start with $5 in free credit.

Free users

Free-plan runs return up to 10 results as a preview. Upgrade your Apify plan to collect up to 1,000,000 results per run.

Run it

1. Create a free Apify account with $5 in credit.
2. Open the IP Geolocation Scraper.
3. Set your inputs and any filters, then click Start.
4. Export the results as CSV, Excel, JSON, or XML from the Dataset tab.

Run it programmatically through the Apify API (run-sync-get-dataset-items) or the ApifyClient for JavaScript and Python.

Use with AI agents (MCP)

Give an AI agent live access to ipapi through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

$claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/ipapi-geolocation-scraper"

Then prompt it in plain language to run the scraper and read back the results.

Troubleshooting

Why am I getting empty or missing fields for some IPs?

The ipapi.co service may not have data for every IP, especially private addresses (10.x.x.x, 192.168.x.x) or very new allocations. Check that the IP is a public, routable address.

The run is slow or seems stuck.

The free ipapi.co endpoint is rate-limited to roughly 45 requests per minute. Large lists will take time. Reduce maxItems or split your list across multiple runs if you need faster throughput.

I get an error about invalid input.

Make sure your IPs input is a valid JSON array of strings, like ["8.8.8.8", "1.1.1.1"]. A single string or an object will cause a parse error.

Some fields I selected are not in the output.

The fields projection input uses exact field names from the schema (e.g., country_name, not country). Check the input schema for the correct field names and re-submit.

The dataset has fewer rows than my IP list.

The maxItems setting caps the total rows collected. If maxItems is smaller than your IP list length, the Actor stops early. Increase maxItems to cover your full list.

FAQ

Question	Answer
Do I need an API key for ipapi.co?	No. This Actor uses the public, rate-limited endpoint of ipapi.co. No registration or API key is required.
How many IPs can I geolocate in one run?	You can set the maxItems input up to 1,000,000. The Actor will process IPs from your list until it reaches that limit or exhausts the input.
What fields are available in the output?	Over 25 fields: city, region, country, postal code, latitude, longitude, timezone, currency, ASN, ISP organization, and more. You can select a subset with the fields projection input.
Does this work with IPv6 addresses?	Yes. The Actor accepts both IPv4 and IPv6 addresses in the same input array.
What happens if an IP address is invalid or private?	The ipapi.co service returns an error or empty fields for addresses it cannot geolocate (like private RFC 1918 addresses). The Actor includes those rows with whatever data the service provides.
Is there a rate limit?	The free ipapi.co endpoint has a rate limit of about 45 requests per minute from a single IP. The Actor respects this and will slow down automatically if needed.
Can I get only the country and city and skip the rest?	Yes. Use the fields projection input to select only the columns you need, such as country_name and city.
What output formats are supported?	You can export the dataset from Apify as CSV, JSON, Excel, or XML.
Does this Actor store my IP list?	Your input IPs are processed during the run and stored in the Apify dataset you own. Apify's platform security applies. Review ipapi.co's privacy policy for their handling.
Can I schedule this to run daily?	Yes. Apify schedules let you run the Actor on a cron expression, so you can enrich a fresh list of IPs every day.

Related actors

Browse the full ParseForge collection for more scrapers.

🆘 Need help? Email parseforge@protonmail.com with your run ID, your input, and what you expected.

⚠️ Disclaimer. This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by ipapi.co. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.