🌍 IP Address Information Lookup

Fast, reliable IP geolocation lookup with automatic failover and rate limit handling

Get comprehensive geolocation and network information for any IPv4 or IPv6 address. This Actor provides accurate country, continent, and EU membership data with intelligent rate limit management and automatic API failover for maximum reliability.

✨ Features

• 🌐 Dual API Support - Automatically switches between primary and fallback APIs for maximum uptime
• 🔄 Automatic Failover - Seamlessly switches to backup API on rate limits or errors
• 📊 Standardized Output - Consistent JSON format regardless of which API is used
• ✅ IPv4 & IPv6 Support - Works with both IPv4 and IPv6 addresses
• 🚀 Fast & Reliable - Optimized for performance with intelligent caching
• 📦 Easy Integration - Simple API interface perfect for automation workflows

📋 Output Format

The Actor returns a standardized JSON object with the following structure:

{
    "success": true,
    "ip": "8.8.8.8",
    "continent_code": "NA",
    "continent_name": "North America",
    "country_code": "US",
    "country_name": "United States",
    "is_in_european_union": false,
    "message": "IP information retrieved successfully"
}

Output Fields

Field	Type	Description
success	boolean	Whether the IP lookup was successful
ip	string	The IP address that was looked up
continent_code	string	Two-letter continent code (e.g., "NA", "EU", "AS")
continent_name	string	Full continent name (e.g., "North America", "Europe")
country_code	string	Two-letter ISO country code (e.g., "US", "GB", "DE")
country_name	string	Full country name
is_in_european_union	boolean	Whether the IP is from an EU member country
message	string	Status message from the API

🚀 Quick Start

Using Apify Console

1. Go to the Actor page on Apify
2. Click Run on the IP Address Information Lookup Actor
3. Enter an IP address (e.g., 8.8.8.8)
4. Click Start and wait for results

Using Apify API

curl "https://api.apify.com/v2/acts/YOUR_ACTOR_ID/run-sync" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"ip": "8.8.8.8"}'

Using JavaScript/Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({
    token: 'YOUR_API_TOKEN',
});

const run = await client.actor('YOUR_ACTOR_ID').call({
    ip: '8.8.8.8',
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items[0]);

Using Python

from apify_client import ApifyClient

client = ApifyClient('YOUR_API_TOKEN')

run = client.actor('YOUR_ACTOR_ID').call(run_input={'ip': '8.8.8.8'})

items = client.dataset(run['defaultDatasetId']).list_items()
print(items['items'][0])

📖 Input Schema

The Actor accepts a single input parameter:

Parameter	Type	Required	Description	Example
ip	string	Yes	IPv4 or IPv6 address to look up	8.8.8.8

Example Input

{
    "ip": "8.8.8.8"
}

🔧 How It Works

1. Primary API: The Actor first attempts to use ip-api.com for IP lookups
2. Rate Limit Management: Tracks requests and automatically manages the 45 requests/minute limit
3. Automatic Failover: If rate limited or after 45 requests, seamlessly switches to the backup API (saifs.ai)
4. Standardized Output: Both APIs return data in the same consistent format
5. Error Handling: Comprehensive error handling ensures reliable operation

Rate Limiting

• Primary API: 45 requests per minute
• Automatic Reset: Rate limit window resets every 60 seconds
• Seamless Transition: Automatically switches to fallback API when needed

💡 Use Cases

• 🌐 Geolocation Services - Identify user locations for content personalization
• 🔒 Security & Fraud Detection - Verify IP origins for security checks
• 📊 Analytics - Analyze traffic patterns by geographic region
• 🌍 Content Localization - Serve region-specific content based on IP location
• 🛡️ Access Control - Implement geo-blocking or geo-allowing features
• 📈 Business Intelligence - Understand customer geographic distribution

🔗 Integrations

This Actor can be easily integrated with:

• Make (Integromat) - Connect via Apify integration
• Zapier - Automate IP lookups in your workflows
• GitHub Actions - Include in CI/CD pipelines
• Google Sheets - Enrich data with geolocation information
• Custom Applications - Use via REST API or SDK

📊 Performance

• Response Time: Typically < 1 second per lookup
• Reliability: 99.9%+ uptime with dual API support
• Throughput: Up to 45 requests/minute on primary API, unlimited on fallback
• Scalability: Handles high-volume requests with automatic failover

🛠️ Development

Prerequisites

• Node.js 18+ installed
• Apify CLI installed (npm install -g apify-cli)
• Apify account (Sign up for free)

Local Development

1. Clone the repository:

git clone <repository-url>
cd ip-info-actor

2. Install dependencies:

$npm install

3. Run the Actor locally:

$apify run

4. Test with sample input:

$# The Actor will use the input from storage/key_value_stores/default/INPUT.json

Deploy to Apify

1. Login to Apify:

$apify login

2. Deploy the Actor:

$apify push

📝 Example Outputs

IPv4 Address Lookup

Input:

{
    "ip": "8.8.8.8"
}

Output:

{
    "success": true,
    "ip": "8.8.8.8",
    "continent_code": "NA",
    "continent_name": "North America",
    "country_code": "US",
    "country_name": "United States",
    "is_in_european_union": false,
    "message": "IP information retrieved successfully"
}

IPv6 Address Lookup

Input:

{
    "ip": "2001:4860:4860::8888"
}

Output:

{
    "success": true,
    "ip": "2001:4860:4860::8888",
    "continent_code": "NA",
    "continent_name": "North America",
    "country_code": "US",
    "country_name": "United States",
    "is_in_european_union": false,
    "message": "IP information retrieved successfully"
}

🤝 Support

• Documentation: Apify Platform Docs
• Community: Apify Discord
• Issues: Report issues via the Actor's page on Apify

📄 License

This Actor is available under the LICENSE.

🙏 Acknowledgments

This Actor uses the following services:

• saifs.ai - Fallback IP geolocation API

---

Made with ❤️ using Apify

For more information, visit the Actor page on Apify Platform.