IP to Country Geolocation API

A reliable Apify Actor for converting IP addresses to comprehensive geolocation information. Supports both single IP and bulk processing with multiple geolocation providers.

Features

• Real-time IP geolocation: High accuracy for IPv4 and IPv6 addresses
• Bulk processing: Efficiently handle large IP datasets
• Multiple providers: IPAPI.co (recommended) and IP-API.com with automatic fallback
• Comprehensive data: Network, geographic, and country information
• Rate limit handling: Intelligent 429 error handling with retry suggestions

Data Providers

• IPAPI.co - Primary provider with 30+ data fields including country demographics, currency, languages, and network details
• IP-API.com - Backup provider with core geographic and network information

Input

{
  "ips": ["8.8.8.8", "1.1.1.1"],
  "provider": "ipapi",
  "includeIspInfo": true
}

Fields

• ips (required): Single IP address or array of IPs (IPv4/IPv6)
• provider (optional): "ipapi" or "ip-api" (default: "ipapi")
• includeIspInfo (optional): Include ISP/organization details (default: true)

Output

The Actor stores results in the default dataset:

[
  {
    "ip": "8.8.8.8",
    "network": "8.8.8.0/24",
    "version": "IPv4",
    "countryCode": "US",
    "countryName": "United States",
    "countryCodeIso3": "USA",
    "countryCapital": "Washington",
    "countryTld": ".us",
    "continentCode": "NA",
    "continentName": "North America",
    "city": "Mountain View",
    "region": "California",
    "regionCode": "CA",
    "postal": "94043",
    "latitude": 37.4056,
    "longitude": -122.0775,
    "timezone": "America/Los_Angeles",
    "utcOffset": "-0800",
    "countryCallingCode": "+1",
    "currency": "USD",
    "currencyName": "Dollar",
    "languages": "en-US,es-US,haw,fr",
    "countryArea": 9629091,
    "countryPopulation": 327167434,
    "asn": "AS15169",
    "isp": "Google LLC",
    "org": "Google LLC",
    "isProxy": false,
    "lookupTime": "2025-11-04T03:15:00.000Z"
  }
]

Access the results via the Dataset tab in Apify Console or the API endpoint provided in the output.

Target Use Cases

• Web Developers: Location-aware applications
• Digital Marketers: Regional campaign analysis
• Cybersecurity: IP threat investigation
• E-commerce: Geo-blocking and regional pricing
• Data Analytics: User base geographic segmentation