Features

IP Location Module

It pinpoints users to the correct city in the vast majority of lookups—and, for much of the dataset, narrows that down even further to precise neighbourhood-level locality.

Country Meta data

We enrich every IP response with country-specific metadata—international calling codes, country's top-level domains (ccTLD), and the nation’s primary languages.

Network Module

The Network module delivers full ASN intel—number, organization, registration country, ASN type, RIR, IPv4/IPv6 route counts, and allocation status—plus company name, and connection type.

Bulk IP Address Lookup

Use our Bulk IP Lookup endpoint to perform batch lookup of multiple IPs in one go. One request can have up to 100 IPs. Both IPv4 and IPv6 are supported.

Common Use Cases

Website Content Localization Serve a visitor the perfect version of your site. By detecting their location, you can greet users in their own language and route them to the region-specific pages that feel most familiar— driving conversion rates by as much as 70 percent.
DDoS source triage Quickly cluster incoming traffic by region or ASN to rate-limit or null-route hostile networks. Pair the geo data with traffic-volume thresholds to auto-generate firewall rules and alert upstream providers when a single ISP or geography exceeds normal baselines.
A/B test segmentation Use geolocation to split experiments by country or city, revealing regional preferences so you can fine-tune features and offers for each market.
Fraud scoring Compare a user’s current IP location with their historical logins, billing address, and shipping destination. Score higher risk when the distance is extreme or when the IP jumps between high-risk regions in short intervals.
Botnet Detection Geo-map bot traffic by city and ASN to spot compromised subnets, auto-block hot zones, and alert local CERTs before small clusters swell into large-scale attacks.
Response
Geolocation API Documentation

Authorization

You can make authorized requests to our API by passing API key as a query parameter. To get your API key, login to our billing dashboard and get your API key! If your API key has been compromised, you can change it by clicking on reset button in billing dashboard.

API GET
https://api.whoisfreaks.com/v1.0/geolocation?apiKey=API_KEY&ip=8.8.8.8
Query Parameters
  • Required
    apiKeyYou can obtain your API key from the billing dashboard.
    ipThe IP address for which you want to fetch geolocation data.
Responses
200 OK
400 IP address 'X.X.X.X' is not valid.
401 Provided API key is invalid.
401 Provided API key is inactive.
401 Please buy a subscription plan or add api credits.
401 Your subscription is deactivated.
401 Repeated payment failures.
401 Your account is deactivated.
401 Suspicious Activity.
404 Record not found.
405 Method not allowed.
408 Unable to fetch whois data.
412 Exceeded the limit of api plan requests.
413 Exceeded the limit of api credits requests.
413 Exceeded the limit of surcharge requests.
423 IP address is from a bogon ip ranges.
429 Maximum request limit reached.
499 Client closed request.
500 Internal Server error.
502 Bad gateway.
503 Service is unavailable.
504 Request is timed-out.
505 Unsupported HTTP Version.
Request
Shell Node.js Java Python PHP Ruby JS C# Go C Swift
GET
Copy
Response
200 400 401 404 405 408 412 413 423 429 499 500 502 503 504 505
Copy
OK

Authorization

You can make authorized requests to our API by passing API key as a query parameter. To get your API key, login to our billing dashboard and get your API key! If your API key has been compromised, you can change it by clicking on reset button in billing dashboard.

The request body is mandatory. Click here to see an example.

API POST
https://api.whoisfreaks.com/v1.0/geolocation?apiKey=API_KEY
Body | raw
{
    "ips":[
        "1.1.1.1",
        "2.2.2.2",
        "8.8.8.8"
    ]
}
Copy
Query Parameters
Request Body
    Add the IP addresses to the request body using the correct parameter. Click here to see a complete example of the request format.
Responses
200 OK
400 Please provide IPs list.
401 Provided API key is invalid.
401 Provided API key is inactive.
401 Please buy a subscription plan or add api credits.
401 Your subscription is deactivated.
401 Repeated payment failures.
401 Your account is deactivated.
401 Suspicious Activity.
404 Record not found.
405 Method not allowed.
408 Unable to fetch whois data.
412 Exceeded the limit of api plan requests.
413 Exceeded maximum list size of 100.
413 Exceeded the limit of surcharge requests.
423 IP address is from a bogon ip ranges.
429 Maximum request limit reached.
499 Client closed request.
500 Internal Server error.
502 Bad gateway.
503 Service is unavailable.
504 Request is timed-out.
505 Unsupported HTTP Version.
Request
Shell Node.js Java Python PHP Ruby JS C# Go C Swift
POST
Copy
Response
200 400 401 404 405 408 412 413 423 429 499 500 502 503 504 505
Copy
OK

Credit Usage API

Using the Geolocation API requires credits. Below is how credits are consumed for each type of lookup:

  • Each successful single geolocation query consumes 1 credit.
  • In bulk operations, 1 credit is deducted for each successfully returned IP response.

You can check your credit usage and remaining balance through this API.

Request
GET
Copy
Response
XML JSON
Copy



FAQs

What is an IP Geolocation API and what does it do?

An IP Geolocation API allows you to fetch a device’s physical location using its IP address. It provides real-time data such as country, city, ISP, timezone, and currency. ipgeolocation.io enhances this with VPN, proxy, and TOR detection—powered by multiple reliable data sources and frequent updates for both IPv4 and IPv6.

What data does the IP Location API provide?

The IP Location API returns detailed IP-based data, including country, region, city, ZIP code, latitude/longitude, timezone, ISP, ASN, and organization. It also detects VPN/proxy usage, threat indicators, and parses user-agent data for device-level insights.

What’s the process to get access to the IP Geolocation API?

To access the API, simply sign up for a free account at WhoisFreaks and then get your API key from our billing dashboard, allowing you to start making requests right away.

What is a VPN and what does it do?

A VPN (Virtual Private Network) is a service that encrypts your internet traffic by creating a secure tunnel between your device and a remote server. This process hides your real IP address and routes your data through the VPN server, making it appear as if you're browsing from a different location. Unlike a proxy, a VPN not only masks your IP and changes your virtual location but also ensures your online activity and sensitive data remain private and protected from prying eyes, offering a higher level of anonymity and security.

Are there any free options for IP Geolocation API access?

Yes, we offer 500 free credits for new users. These allow access to core features like country, city, ISP, timezone, and currency. You can upgrade for higher usage limits and advanced features such as VPN/proxy/TOR detection.

How reliable is the location data from Geolocation API?

The API delivers over 99% accuracy at the country level and around 85%+ at the city level, with a typical accuracy range of 20–50 km. The database is updated daily and built from trusted sources for precise geolocation and supporting details like ISP and timezone.

How is the IP Location API secured?

All requests to the API are encrypted via HTTPS. ipgeolocation.io also uses globally distributed servers and edge nodes for uptime and DDoS protection, and it fully complies with data privacy laws like GDPR to ensure secure and ethical data use.

Can I perform bulk IP lookups with the IP Location API?

Yes, the API supports bulk IP lookups for up to 100 IPs per request. This feature is available on paid plans, and each IP in the batch counts toward your overall API usage.

What is the update frequency of the IP Location API data?

IP data is refreshed every 24 hours to ensure accuracy. Additionally, downloadable geolocation databases are available with weekly and monthly update options.

What is the number of free API credits available for new users, and are these credits rate-limited?

We will provide 500 API credits to new users and yes, those credits have a rate-limiting of 10 requests per minute for Live APIs, 5 requests per minute for Bulk Domain Lookup, and 1 request per minute for Reverse/Historical Endpoints.

Do you have rate limiting on the number of requests being made on your paid plans?

Yes, we have rate limiting on requests being made on all of our paid plans. The requests limit is shown in the following table.

The Table is divided into three types of plans:

1) API Credits

Credits Live-rpm Bulk-rpm Historical/Reverse-rpm
5000 20 8 3
15000 35 12 5
50000 80 20 10
150000 120 25 15
450000 150 35 20
1000000 200 50 25
3000000 300 70 35

2) API Subscription

Credits Live-rpm Bulk-rpm Historical/Reverse-rpm
5000 20 8 3
15000 35 12 5
50000 80 20 10
150000 120 25 15
450000 150 35 20
1000000 200 50 25
3000000 300 70 35
  • Live-rpm: API requests per minute limit for live Whois lookup API, domain availability API, SSL certificate lookup API, and DNS lookup API endpoints.
  • Bulk-rpm: API requests per minute limit for bulk domain Whois lookup API endpoint.
  • Historical/Reverse-rpm: API requests per minute limit for historical, and reverse Whois API endpoints.

In case, the request per minute exceeds, it'll throw an error with HTTP error code of 429.

Do you provide any headers in API response regarding rate limiting?

Yes, there are following three header parameters in the response:

  • X-RateLimit-Allowed-Requests: Tells the max allowed API requests per minute on a specific plan.
  • X-RateLimit-Remaining-Requests: Tells the remaining API requests per minute for that plan.
  • X-RateLimit-Remaining-Time: Tells after how much time the API requests per minute will be reset.
Whois footer banner