Instant IP Address Lookup (Apify Actor)

Instant IP Address Lookup is an Apify actor for IP address lookup and IP geolocation. It returns clean, structured results for:

• Location: country, region/state, city, ZIP/postal code, latitude & longitude
• Network: ISP, ASN, IP version (IPv4/IPv6)
• Security signals: proxy/VPN detection (when available)
• Time: timezone and local current time

Use it to enrich IPs in your workflows and export the dataset as JSON / CSV / Excel.

---

Table of Contents

1. Overview
2. Key Features
3. Use Cases
4. Input
5. Output
6. Dataset Views
7. Examples
8. Best Practices
9. FAQ
10. Keywords (SEO)

---

Overview

🔎 This actor helps you lookup any IPv4 or IPv6 address and fetch:

• IP geolocation: country, region, city, latitude, longitude, ZIP/postal code
• Network data: ISP, ASN, IP version, timezone, current local time
• Proxy / VPN detection: whether the IP is a proxy and related proxy metadata (if available)

Results are saved as one dataset item per IP address.

Typical integrations:

• Security checks
• Fraud & risk scoring
• Lead enrichment
• Geo-targeting / compliance

---

Key Features

• ⚡ Fast IP address lookup for single or batch runs
• 🌍 Supports IPv4 and IPv6
• 🛡️ Proxy/VPN detection (when available)
• 📦 Structured, export-ready dataset (JSON/CSV/Excel)
• 📊 Clean dataset table views for quick analysis

---

Use Cases

• IP geolocation lookup for analytics, dashboards, and personalization
• Detect proxy/VPN traffic for abuse prevention and moderation
• Fraud detection and account security checks
• Lead enrichment: map IP addresses to country/city and ISP
• Compliance / geo-restriction: validate traffic origin

---

Input

The actor input is configured from the Apify UI and stored in the default INPUT.

Field	Type	Required	Description
ipAddresses	array of strings	Yes	List of IPv4/IPv6 addresses to lookup. Duplicates are removed automatically.

Limits:

• Minimum: 1
• Maximum: 100

---

Output

Each dataset item represents one IP address.

Output fields (common)

Field	Type	Description
ip	string	The IP address that was looked up.
ipVersion	number	IP version, e.g. 4 or 6.
valid	boolean	Whether the IP is valid according to the lookup response.
flag	string	Country flag emoji, when available.
countryCode	string	ISO alpha-2 country code.
country	string	Country name.
region	string	Region/state name.
city	string	City name.
zipCode	string	ZIP/postal code (if available).
latitude	number	Latitude.
longitude	number	Longitude.
timeZone	string	Timezone offset or identifier (if available).
currentTime	string	Current local time (if available).
isp	string	Internet Service Provider.
asn	string	Autonomous System Number.
isProxy	boolean	Proxy/VPN indicator (if available).
proxy	object	Proxy details (optional).
status	string	success or failed.
error	string	Error message when failed.
errorCode	number	HTTP-like error code when failed.
timestamp	string	When the item was produced.

---

Dataset Views

📊 This actor includes a clean table experience using these dataset views:

• overview — quick summary (IP, location, ISP, proxy)
• location — detailed location fields (country/region/city/coordinates)
• network — network & security fields (ISP/ASN/proxy details)

---

Examples

Example 1: Lookup a single IP address

{
  "ipAddresses": ["8.8.8.8"]
}

Example 2: Batch IP lookup (IPv4 + IPv6)

{
  "ipAddresses": [
    "35.209.198.222",
    "8.8.8.8",
    "2001:4860:4860::8888"
  ]
}

---

Best Practices

• Provide clean IP addresses (no ports, no URLs). Example: use 8.8.8.8, not 8.8.8.8:443.
• For large scale pipelines, run this actor via Apify API and store results in a dedicated dataset.
• If you need to enrich millions of IPs, consider batching + retries in your orchestration layer.

---

FAQ

Q: Does this actor support IPv6?
A: Yes, it supports both IPv4 and IPv6.

Q: Why do I get failed for some IPs?
A: Common reasons are invalid input, rate limits (429), or The actor stores error and errorCode for each failed item.

Q: Will it always detect VPN/Proxy correctly?
A: Proxy/VPN detection accuracy depends on the underlying data source. This actor outputs the available fields returned by the lookup.

Q: Where do I see the results?
A: Results are saved to the actor’s default dataset. You can export as JSON/CSV/Excel.

---

Keywords (SEO)

• ip address lookup
• ip lookup api
• ip geolocation lookup
• ip to location
• ip address geolocation
• detect proxy ip
• vpn detection
• proxy detection api
• isp lookup
• asn lookup
• apify ip lookup actor
• proxy checker

---

If this actor helps your workflow, please consider leaving a rating on Apify.