Frequently Asked Questions

Find answers to common questions about our IP geolocation services.

General Questions

IP geolocation is the process of determining the geographic location of an internet-connected device using its IP address. This includes information like country, region, city, timezone, and approximate coordinates. It's commonly used for content personalization, fraud prevention, and analytics.

IP geolocation accuracy varies. Country-level accuracy is typically 99%+, while city-level accuracy is usually 70-80% depending on the region. Urban areas tend to have higher accuracy than rural areas. Note that VPNs, proxies, and mobile networks can affect accuracy.

We use MaxMind's GeoLite2 database, which is a widely trusted source for IP geolocation data. The database is regularly updated to maintain accuracy. We use both the City and ASN databases to provide comprehensive location and network information.

We update our MaxMind GeoLite2 database regularly to ensure accuracy. The database is typically updated weekly with the latest IP allocation and location information from regional internet registries and other sources.

Yes, you can lookup your own IP address by making a request to our API without specifying an IP parameter, or by visiting our website and using the IP lookup tool. The system will automatically detect and geolocate your current public IP address.

VPNs and proxies route traffic through different servers, so our service will return the location of the VPN/proxy server, not the user's actual location. While we cannot definitively detect all VPNs, some IP ranges are flagged as known VPN providers or data centers.

API Questions

To get API access, simply create a free account on our website. Once registered, you can access your API token from your dashboard. The token is used to authenticate your API requests.

Rate limits depend on your account type. Free accounts have reasonable limits for development and testing. For higher limits, please contact us about premium plans. Rate limit information is included in API response headers.

Yes! Our API supports bulk lookups, allowing you to query multiple IP addresses in a single request. This is more efficient than making individual requests for each IP address. Check our API documentation for details on bulk endpoint usage.

Yes, our service fully supports both IPv4 and IPv6 addresses. You can look up any valid IP address format, and our system will automatically detect and process it correctly.

Our API returns comprehensive geolocation data including IP address, country, region, city, postal code, latitude, longitude, timezone, ISP/organization name, ASN (Autonomous System Number), and accuracy radius. All data is returned in JSON format for easy integration.

Yes, our API supports Cross-Origin Resource Sharing (CORS), allowing you to make requests directly from web browsers. However, for security reasons, we recommend making API calls from your backend server to protect your API key.

Our API can be integrated with any programming language that supports HTTP requests. We provide official code examples and SDKs for popular languages including JavaScript, Python, PHP, Ruby, Java, Go, C#, and more. You can find these in our documentation.

Privacy & Security

For registered users, we log API requests for analytics and usage tracking purposes. This helps you monitor your usage from your dashboard. For anonymous lookups on our website, we do not store the queries. See our Privacy Policy for more details.

Yes, all API connections are secured using HTTPS/TLS encryption. We do not support unencrypted HTTP connections to ensure your data and API tokens remain secure during transmission.

We are compliant with major data protection regulations including GDPR, CCPA, and other regional privacy laws. We do not collect personally identifiable information through our geolocation service. IP addresses are processed as necessary for providing the service and are not sold or shared with third parties.

We retain API request logs for 90 days for all paid accounts to support usage analytics and troubleshooting. After 90 days, detailed logs are deleted, though aggregated usage statistics are retained longer. Free tier users have logs retained for 30 days. You can request data deletion at any time.

Service & Features

Yes, our service can be used for commercial purposes. We offer different plans to suit various business needs, from small startups to enterprise applications. Please review our Terms of Service for specific usage guidelines.

Common use cases include content localization, fraud detection and prevention, targeted advertising, analytics and reporting, access control and geo-blocking, compliance with regional regulations, personalized user experiences, and security monitoring.

Our API typically responds in under 50 milliseconds for single IP lookups. Response times may vary based on your location, network conditions, and whether you're making single or bulk requests. We maintain 99.9% uptime for reliable service.

We maintain a 99.9% uptime SLA (Service Level Agreement) for all paid plans. Our infrastructure is distributed across multiple data centers with automatic failover and redundancy to ensure high availability. You can check our real-time status at any time on our status page.

Yes, many of our customers use our IP geolocation service as part of their fraud detection systems. By identifying the geographic location of transactions and comparing it with user-provided information, you can detect suspicious activity. However, always use IP geolocation as one of multiple fraud indicators.

ASN (Autonomous System Number) identifies the network operator that owns an IP address range. This information is useful for identifying the ISP, hosting provider, or organization behind an IP address. It can help with security analysis, network troubleshooting, and understanding traffic sources.

Integration & Technical

Yes, comprehensive API documentation is available in your dashboard after registration. It includes endpoint details, request/response examples, error codes, rate limiting information, and code samples in multiple programming languages.

Our API returns standard HTTP status codes and detailed error messages in JSON format. Common errors include 401 (unauthorized), 429 (rate limit exceeded), and 404 (IP not found). Implement proper error handling in your application to gracefully manage these responses.

Yes, you can cache API responses to improve performance and reduce API calls. We recommend caching geolocation data for at least 24 hours as IP locations don't change frequently. However, always respect our Terms of Service regarding data usage and redistribution.

Yes, we offer a free tier for development and testing purposes with reasonable rate limits. This allows you to evaluate our service before upgrading to a paid plan. Free accounts include access to all geolocation features with usage limits.

You can manage your API keys from your dashboard. We recommend rotating keys periodically for security, using different keys for different applications, and never exposing keys in client-side code. You can generate, revoke, and monitor key usage at any time.

Yes, our API is accessible over standard HTTPS (port 443), which works with most firewall configurations. If you have specific network security requirements or need to whitelist IP addresses, please contact our support team for assistance.

We maintain API version stability and provide advance notice of any breaking changes. Current API version is included in the endpoint URL. When new versions are released, we maintain backward compatibility with previous versions for a minimum of 12 months before deprecation.

If an IP address is not found in our database (typically private/reserved IP addresses or very new allocations), the API will return a 404 status code with an appropriate error message. Private IP ranges like 192.168.x.x and 10.x.x.x are not geolocatable.

Your free tier account serves as a testing environment. You can make real API requests with rate limits suitable for development and testing. There is no separate sandbox environment, but you can test all features with the free tier before upgrading.

Billing & Pricing

We offer multiple pricing tiers to suit different needs: Free tier for development and testing, Starter plan for small projects, Professional plan for growing businesses, and Enterprise plan for large-scale applications. Each plan offers different rate limits and features.

Usage is billed based on the number of API requests made during your billing period. Unused requests do not roll over to the next billing cycle. You can monitor your usage in real-time from your dashboard and upgrade or downgrade your plan at any time.

If you exceed your rate limit, the API will return a 429 (Too Many Requests) HTTP status code. You can either wait until your rate limit resets (typically hourly or daily depending on your plan) or upgrade to a higher tier plan with increased limits.

We offer a 30-day money-back guarantee for new subscriptions. If you are not satisfied with our service, you can request a full refund within 30 days of your initial purchase. For more details, please review our refund policy or contact our support team.

Yes, you can upgrade or downgrade your plan at any time from your dashboard. When you upgrade, the change takes effect immediately. When you downgrade, the change will take effect at the start of your next billing cycle. Pro-rated credits are applied where applicable.

We accept all major credit cards (Visa, MasterCard, American Express, Discover) and debit cards. For enterprise plans, we also offer invoicing options with payment via bank transfer or check. All payments are processed securely through industry-standard payment processors.

You can cancel your subscription at any time from your account settings. Once canceled, you will continue to have access to your plan features until the end of your current billing period. After that, your account will revert to the free tier.

Account Management

To reset your password, click the "Forgot Password" link on the login page. Enter your email address, and we will send you a password reset link. Follow the instructions in the email to create a new password. If you do not receive the email, check your spam folder or contact support.

Yes, you can change your email address from your account settings. After submitting a new email address, we will send a verification email to confirm the change. You must click the verification link to complete the email address update.

To delete your account, go to your account settings and select the "Delete Account" option. Please note that account deletion is permanent and cannot be undone. All your data, API keys, and usage history will be permanently removed. Active subscriptions will be canceled.

Team collaboration features are available on our Professional and Enterprise plans. These plans allow you to add multiple team members with different permission levels, share API keys securely, and manage team access from a central dashboard.

You can update your billing information, including payment method and billing address, from your account settings under the Billing section. Changes to your payment method will be used for all future billing cycles.

Support & Advanced Topics

You can report bugs or technical issues through our support portal, by email, or via the contact form on our website. Please include as much detail as possible, including error messages, request/response examples, and steps to reproduce the issue.

Yes, we offer technical support to all users. Free tier users have access to email support with responses within 48 hours. Paid plan users receive priority support with faster response times. Enterprise customers get dedicated support with SLA-backed response times.

Absolutely! We welcome feature requests from our users. You can submit feature requests through our feedback portal or contact our support team. We regularly review user feedback and prioritize features based on user demand and technical feasibility.

White-label options are available for Enterprise customers. This allows you to use our API infrastructure under your own branding. Contact our sales team to discuss white-label requirements, pricing, and customization options.

Yes, we offer SLAs starting with our Professional plan. SLAs cover uptime guarantees, API response time commitments, and support response times. Enterprise customers can negotiate custom SLAs based on their specific requirements.

We use the MaxMind GeoLite2 City database which includes both country and city-level information. This provides the most comprehensive data including country, region, city, postal code, coordinates, and ISP information. Country-only lookups are faster but provide less detailed information.

We use MaxMind's GeoLite2 database, which is freely available for download from MaxMind's website under their license terms. However, our service adds value through our API infrastructure, regular updates, high availability, and support. Database downloads are not included with API plans.

Still have questions?

Can't find the answer you're looking for? Please contact our support team.

Contact Support