Logo
Logo

PRODUCTS

TOOLS

Pinpoint Location Insights with ourIP Geolocation APIin Milliseconds

Enterprise-grade IP Location API for Threat Intelligence: Pinpointing Users’ Geographic Location with City-Level Accuracy and Radius at Global Scale.

1[
2  {
3    "ip": "8.8.8.8",
4    "location": {
5      "continent_code": "NA",
6      "continent_name": "North America",
7      "country_code2": "US",
8      "country_code3": "USA",
9      "country_name": "United States",
10      "country_name_official": "United States of America",
11      "country_capital": "Washington, D.C.",
12      "state_prov": "California",
13      "state_code": "US-CA",
14      "district": "Santa Clara",
15      "city": "Mountain View",
16      "locality": "Mountain View",
17      "accuracy_radius": "",
18      "zipcode": "94043-1351",
19      "latitude": "37.42240",
20      "longitude": "-122.08421",
21      "is_eu": false,
22      "geoname_id": "6301403",
23      "country_emoji": "🇺🇸"
24    },
25    "country_metadata": {
26      "calling_code": "+1",
27      "tld": ".us",
28      "languages": [
29        "en-US",
30        "es-US",
31        "haw",
32        "fr"
33      ]
34    },
35    "network": {
36      "asn": {
37        "as_number": "AS15169",
38        "organization": "Google LLC",
39        "country": "US",
40        "asn_name": "GOOGLE",
41        "type": "BUSINESS",
42        "domain": "about.google",
43        "date_allocated": "",
44        "allocation_status": "assigned",
45        "num_of_ipv4_routes": "967",
46        "num_of_ipv6_routes": "104",
47        "rir": "ARIN"
48      },
49      "connection_type": "",
50      "company": {
51        "name": "Google LLC",
52        "type": "",
53        "domain": ""
54      }
55    },
56    "currency": {
57      "code": "USD",
58      "name": "US Dollar",
59      "symbol": "$"
60    }
61  }
62]
pricing backgroundEclipse Top RightEclipse Top LeftEclipse WHOIS Stats
1528+
TLDs
690M+
Active Domains
877M+
Domains Tracked
3554M+
WHOIS Records
4931M+
Host Names
13B+
DNS Records

Product

IP GeolocationAPI
Identify IP locations with precision for targeting, localization, and threat detection using our real-time IP Geolocation API.
IP Geolocation API

Our lightning-fast IP Location API pinpoints every visitor’s country, city, ZIP/postal code, latitude-longitude pair, and even neighbourhood-level locality with an accompanying accuracy radius. It provides well parsed data in JSON and XML format.

monitoring

Product

Bulk GeolocationLookup
Instantly process and geolocate multiple IP addresses at once using our Bulk Geolocation API.
Bulk Geolocation API

The Bulk Geolocation API lets you submit up to 100 IPv4 or IPv6 addresses in a single request and instantly receive detailed geolocation data for each one in JSON format. It’s optimized for high-volume processing, making it ideal for applications that need to analyze large numbers of IPs quickly and efficiently.

monitoring

Features

What OurGeolocation APIOffers

Real-time IP lookup and comprehensive geolocation database for targeting, personalization, and threat detection.

Feature icon

IP Location Module

It pinpoints users to the correct city in most lookups and often down to the exact neighbourhood.

Feature icon

Country Metadata

We enrich every IP response with country-specific metadata like calling codes, ccTLDs, and primary languages.

Feature icon

Network Module

The Network module provides full ASN intel like organization, country, type, RIR, allocation, company, and connection type.

Feature icon

Bulk IP Address Lookup

Use our Bulk IP Lookup endpoint to perform batch lookup of multiple IPs in one go. This will speed up your Analysis.

Feature icon

Country Level Accuracy

Determines the country associated with a given IP address with accuracy slightly above 90%.

Feature icon

City Level Accuracy

Accurately maps an IP address to a specific city or metro area with high precision for fraud detection and access control.

Feature icon

Zip Code & Timezone

Identifies an IP’s postal/ZIP code and time zone to enable precise delivery, localized experiences, and anomaly detection.

Feature icon

Latitude and Longitude

Provides the geographical coordinates (latitude and longitude) corresponding to the IP address location.

Product

IP GeolocationDatabase
Locates suspicious activity accurately with city and state-level Geo IP data.
IP Geolocation Database

Pinpoint the true origin of suspicious activity with WhoisFreaks’ Geo IP Database. Whether you're tracking threat actors, preventing fraud, or customizing user experiences, our data gives you accurate location insights down to the city and state level. It also includes IP to City and IP to country database.

monitoring

Use Cases

Geolocation in Action

See how IP address location insights power targeted marketing and real-time threat detection.

Feature icon

Threat Origin Detection

Use geolocation data to correlate IP addresses with precise locations, trace threat origins, and mitigate attacks in time.

Feature icon

Anomaly Detection

Flag unusual activity such as rapid logins from distant locations that may indicate account compromise.

Feature icon

Policy Enforcement and Compliance

Comply with data residency laws (e.g., GDPR) by restricting access or applying region-aware policies on the website.

Feature icon

Personalize Content

Deliver geo-targeted content by region using an IP location API to boost engagement and increase conversions.

Feature icon

Fraud Scoring

Compare the user’s IP against historical data and flag extreme or rapid shifts to high-risk locations or VPN usage.

Feature icon

Geofencing and Content Filtering

Use an IP location API to block risky access, protect sensitive services, and restrict adult content by region.

Request demo background

Use IP geolocation for location context to logins and transactions. Correlate anomalies such as impossible travel to detect and block suspicious activity.

pricing background

Documentation

IP Geolocation Lookup

IP Geolocation API provides real-time and accurate geolocation, network, abuse, and security information for any IPv4 or IPv6 address.

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.

Query Parameters

Required
  • apiKey
    You can obtain your API key from the billing dashboard.
  • ip
    The IP address for which you want to fetch geolocation data.

Request

shellnodejsjavapythonphprubyjscsharpgocswiftjquery
SHELL
Loading request...

Response

Loading response...

Status Codes

Success Codes
  • 200Request is processed successfully.
Failure Codes
  • 400Provided name, service or IP address 'XXX.XXX.XXX.XXX' is not valid.
  • 401Provided API key is invalid.
  • 401Provided API key is inactive.
  • 401Please buy a subscription plan or add api credits, then use this api key.
  • 401Your subscription is deactivated. Please buy new plan or add api credits for using whoisfreaks APIs.
  • 401Your subscription is deactivated due to much time payment failure. Please buy a new plan or add api credits for using whoisfreaks APIs.
  • 401Your account is deactivated.
  • 401You are blocked due to suspicious activity.
  • 404The requested IP does not not exists in our database.
  • 405Invalid HTTP request method is being used for calling the endpoint. Only GET and POST methods are allowed. POST method for bulk endpoint and GET method for single lookup endpoint requests.
  • 408Unable to fetch whois data. Please try again.
  • 412You have exceeded the limit of api plan requests and your subscription is canceled.
  • 413You have exceeded the limit of api credits requests [allowed_request_no]. Please upgrade your plan.
  • 413You have exceeded the limit of Surcharge Requests [allowed_surcharge_request_no]. Please upgrade your plan.
  • 423The IP address you provided falls within bogon IP ranges, which are not routable on the public internet. Please make sure to use a valid, publicly accessible IP address for accurate results.
  • 429Please slow down. Your maximum request limit per minute is reached.
  • 499The request or connection timeout you’ve set is too short, which is causing the server to close the connection before completing the response. Please increase the timeout duration to ensure successful communication with the server.
  • 500Internal Server error occurred.
  • 502Please provide ips in request body.
  • 503Service is unavailable. Please try after some time.
  • 504Request is timed-out.
  • 505You might be using an outdated HTTP version.

Bulk IP Geolocation Lookup

The Bulk IP Geolocation API delivers real‑time geolocation data, along with network and security details, for up to 100 IPv4 or IPv6 addresses in a single request.

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.

Query Parameters

Required
  • apiKey
    Get your API key from our billing dashboard.

Request

shellnodejsjavapythonphprubyjscsharpgocswiftjquery
SHELL
Loading request...

Response

Loading response...

Status Codes

Success Codes
  • 200Request is processed successfully.
Failure Codes
  • 400Please provide IPs in the request body..
  • 401Provided API key is invalid.
  • 401Provided API key is inactive.
  • 401Please buy a subscription plan or add api credits, then use this api key.
  • 401Your subscription is deactivated. Please buy new plan or add api credits for using whoisfreaks APIs.
  • 401Your subscription is deactivated due to much time payment failure. Please buy a new plan or add api credits for using whoisfreaks APIs.
  • 401Your account is deactivated.
  • 401You are blocked due to suspicious activity.
  • 404The requested IP does not not exists in our database.
  • 405Invalid HTTP request method is being used for calling the endpoint. Only GET and POST methods are allowed. POST method for bulk endpoint and GET method for single lookup endpoint requests.
  • 408Unable to fetch whois data. Please try again.
  • 412You have exceeded the limit of api plan requests and your subscription is canceled.
  • 413The requested list size is [GREATER_THAN_100] which exceeds the maximum list size of 100.
  • 413You have exceeded the limit of Surcharge Requests [allowed_surcharge_request_no]. Please upgrade your plan.
  • 423The IP address you provided falls within bogon IP ranges, which are not routable on the public internet. Please make sure to use a valid, publicly accessible IP address for accurate results.
  • 429Please slow down. Your maximum request limit per minute is reached.
  • 499The request or connection timeout you’ve set is too short, which is causing the server to close the connection before completing the response. Please increase the timeout duration to ensure successful communication with the server.
  • 500Internal Server error occurred.
  • 502Please provide ips in request body.
  • 503Service is unavailable. Please try after some time.
  • 504Request is timed-out.
  • 505You might be using an outdated HTTP version.
FAQs
Enhance your apps with industry leading web scraping and crawling.
What is an IP Geolocation API and what does it do?
What data does the IP Location API provide?
What’s the process to get access to the IP Geolocation API?
What is a VPN and what does it do?
Are there any free options for IP Geolocation API access?
How reliable is the location data from Geolocation API?
How is the IP Location API secured?
Can I perform bulk IP lookups with the IP Location API?
What is the update frequency of the IP Location API data?
What is the number of free API credits available for new users, and are these credits rate-limited?
Do you have rate limiting on number of requests being made on your paid plans?
Do you provide any headers in API response regarding rate limiting?

Ready to get started?

Join now and claim 500 credits for free!

Elevate your cybersecurity strategy with our all-in-one domain and IP intelligence platform empowering analysts, researchers, and brand owners with real-time WHOIS, DNS, IP, and subdomain insights.

Sign Up For Free