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 json { "ipAddresses": ["8.8.8.8"] } ### Example 2: Batch IP lookup (IPv4 + IPv6) json { "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.