IP Geolocation API JavaScript Client-Side Plugin
Overview
This document provides a comprehensive guide for setting up and using the IP Geolocation API client-side JavaScript plugin. It includes detailed descriptions of configuration options, example usage, and error handling. The plugin lets you use two APIs: the IP Geolocation API and the IP Security API, so you can add geolocation and IP threat detection features to your website or app.
This plugin provides accurate geolocation details for any IPv4 or IPv6 address. It provides important information such as country, state, city, ZIP code, latitude, longitude, accuracy radius, confidence level, DMA code, connection type, ISP/company information, and ASN data. These details help you show location-based content or understand where your users are coming from. You can also get abuse contact information, which helps you report suspicious or malicious activity.
Along with location data, the plugin also includes security lookup capability if you have a paid plan subscription. It can detect VPNs, proxy usage, residential proxies, Tor connections, relay networks, anonymous activity, known attackers, bots, spam sources, and cloud hosting providers, and also provides a threat score to assess risk.
The plugin further offers extra features like time zone details, currency information, and device data parsed from the User-Agent string. These details help you customize content, set the correct time zone, or display prices in the user's local currency.
Client-Side Plugin Purpose
With our Free plan, you get basic location details like country, state, city, ZIP code, currency, basic ASN, and time zone. Paid plans include the same features and add network details (ASN type, domain, RIR, company), user-agent parsing, hostname resolution, security threat detection, abuse contact data, geo accuracy fields, and DMA codes.
This plugin lets developers integrate and use IP geolocation data in their web projects. Developers can use this plugin for various purposes, such as:
- Geographic Redirection: Redirect visitors to region-specific site versions to enhance user experience and compliance with local regulations.
- Analytics Enhancement: Use geolocation data to analyze web traffic and user behavior, enhancing site and content strategies.
- Marketing Geo-targeting & Region Segmentation: Personalize content, offers, or marketing campaigns based on the visitor's region, DMA code, or currency for higher engagement and conversion.
- Form Automation: Pre-fill forms with country, state, city, zip code, and currency information, speeding up the checkout and registration processes.
- Digital Rights Management: Restrict or grant access to content based on the user's location to comply with legal restrictions.
- ISP & ASN Attribution: Determine the internet service provider and ASN ownership behind an IP address for auditing, routing analysis, and attribution.
- Suspicious Traffic Detection & Filtering: Detect and mitigate malicious activities by identifying traffic from suspicious locations or those using VPNs, proxies, Tor, relays, and known attackers.
- Abuse Contact Identification: Identify abusive or malicious IPs by retrieving their registered abuse contacts, enabling automated reporting and proactive threat response.
- Access Control: Block or restrict access from specific countries to comply with export controls or to reduce fraud and abuse.
- Hostname Resolution (DB, Live, Fallback): Retrieve the hostname of an IP using a fast internal database, live DNS lookup, or a fallback of both. Useful for reverse DNS auditing and attribution.
- Client Environment Profiling: Gain insights into the client's device, browser, and operating system to support adaptive UI/UX and environment-specific optimizations.
- Timezone Synchronization: Display times and dates in the local time zone for events, posts, or deadlines, ensuring clarity and consistency for global users.
- Language and Currency Customization: Automatically display content in the user's language and currency based on their geographic location.
Requirements
- Active internet connection
- API Key: Sign up at IPGeolocation.io
How to Get Your API Key
- Sign up here: https://app.ipgeolocation.io/signup
- (Optional) Verify your email if you signed up using an email address.
- Log in to your account: https://app.ipgeolocation.io/login
- After logging in, navigate to your Dashboard to find your API key: https://app.ipgeolocation.io/dashboard
Configurations
By default, the plugin waits up to 2 minutes for an API response and accepts responses up to 16 MiB. If you need a different limit, set timeoutMs (milliseconds) or maxResponseBytes (bytes) when you create the client. The plugin stops at redirects.
1. IPGeolocationAPI: Authentication & Input
| Option | Type | Description |
|---|---|---|
apiKey | string | Your API key. Required unless the request origin is whitelisted (available only on paid plans). |
ipAddress | string | IPv4, IPv6, or domain name to query. If omitted, the plugin auto-detects the user's IP. |
2. IPGeolocationAPI: Basic Response Customization
| Option | Type | Description |
|---|---|---|
fields | string | Comma-separated list of fields to include in the response. Available on all plans. |
excludes | string | Comma-separated list of fields to exclude from the response. Available on all plans. |
lang | string | Language code for translated fields (default: en). Requires a paid plan. Supported values: de, ru, ja, fr, cn, es, cs, it, ko, fa, pt, ar. |
3. IPGeolocationAPI: include Options and Plan Availability
| Option | Type | Description | Free | Paid |
|---|---|---|---|---|
includeHostname | boolean | Include hostname from IPGeolocation.io's IP-Hostname database. | ||
includeLiveHostname | boolean | Use live DNS sources to resolve hostname. | ||
includeHostnameFallbackLive | boolean | Try database first, fall back to live sources if not found. | ||
includeUserAgent | boolean | Include parsed client browser and device info. | ||
includeGeoAccuracy | boolean | Add accuracy_radius, confidence, and locality to location. | ||
includeDmaCode | boolean | Add dma_code to the location object (US IPs only). | ||
includeAbuse | boolean | Include IP abuse contact information. | ||
includeSecurity | boolean | Include VPN, proxy, Tor, relay, and threat detection. | ||
includeAll | boolean | Include all optional modules in a single request (include=*). |
4. IPGeolocationAPI: Storage Option
| Option | Type | Description |
|---|---|---|
saveToSessionStorage | boolean | Caches successful responses for the same endpoint, request options and API key. API keys are hashed in cache identifiers. Requests continue without caching if browser storage is unavailable, or if an API key is used and Web Crypto is unavailable. |
5. IPSecurityAPI: Authentication & Input
| Option | Type | Description |
|---|---|---|
apiKey | string | Your API key. Required unless the request origin is whitelisted (available only on paid plans). |
ipAddress | string | IPv4 or IPv6 address to query. If omitted, the plugin auto-detects the user's IP. |
6. IPSecurityAPI: Response Customization
| Option | Type | Description |
|---|---|---|
fields | string | Comma-separated list of security object fields to include (e.g. security.threat_score). |
excludes | string | Comma-separated list of security object fields to exclude (e.g. security.is_tor). |
7. IPSecurityAPI: Storage Option
| Option | Type | Description |
|---|---|---|
saveToSessionStorage | boolean | Caches successful responses for the same endpoint, request options and API key. API keys are hashed in cache identifiers. Requests continue without caching if browser storage is unavailable, or if an API key is used and Web Crypto is unavailable. |
8. Network Access and Browser Storage
The plugin also sends a background GET to https://us-central1-ipgeolocation-414906.cloudfunctions.net/task. It sends no API key or lookup parameters in that request. After a successful response, the plugin stores a 24-hour marker named geoLocationData in localStorage. This is separate from the lookup-result cache controlled by saveToSessionStorage. If your site restricts outbound connections, allow this host as well.
Setup Plugin
To access this service, add the following JavaScript tag (usually within the <head> block of your pages).
<script src="https://static.ipgeolocation.io/ipgeolocation-api-plugin.v3.0.3.js"></script>API Key Usage Example
Demonstrates how to use the plugin with and without an API key. The API key is optional if the request originates from a whitelisted domain (available only on paid plans).
On a paid plan, register your site as a Request Origin in the dashboard before using this example. On the Free plan, make the lookup on your server with a key stored in an environment variable.
1. No API Key (Request Origin is Whitelisted)
<script>
(async () => {
const ipGeoAPI = new IPGeolocationAPI();
const resp = await ipGeoAPI.getGeolocation();
if (!resp.error_message) {
console.log(resp);
} else {
console.log("Something went wrong while fetching data", resp);
}
})();
</script>2. With API Key
Local testing only. Anyone who opens the page can read a key placed in it.
<script>
(async () => {
const ipGeoAPI = new IPGeolocationAPI({
apiKey: "YOUR_IPGEOLOCATION_API_KEY",
});
const resp = await ipGeoAPI.getGeolocation();
if (!resp.error_message) {
console.log(resp);
} else {
console.log("Something went wrong while fetching data", resp);
}
})();
</script>Free Plan Examples
These examples request only fields that the Free plan returns. Without an API key, they run only from a registered Request Origin, which needs a paid plan.
1. Get Default Geolocation Fields
<script>
(async () => {
const ipGeoAPI = new IPGeolocationAPI();
const resp = await ipGeoAPI.getGeolocation();
if (!resp.error_message) {
console.log(resp);
} else {
console.log("Something went wrong while fetching data", resp);
}
})();
</script>Sample Response:
{
"ip": "8.8.8.8",
"location": {
"continent_code": "NA",
"continent_name": "North America",
"country_code2": "US",
"country_code3": "USA",
"country_name": "United States",
"country_name_official": "United States of America",
"country_capital": "Washington, D.C.",
"state_prov": "California",
"state_code": "US-CA",
"district": "Santa Clara",
"city": "Mountain View",
"zipcode": "94043-1351",
"latitude": "37.42240",
"longitude": "-122.08421",
"is_eu": false,
"country_flag": "https://ipgeolocation.io/static/flags/us_64.png",
"geoname_id": "6301403",
"country_emoji": "🇺🇸"
},
"country_metadata": {
"calling_code": "+1",
"tld": ".us",
"languages": ["en-US", "es-US", "haw", "fr"]
},
"currency": {
"code": "USD",
"name": "US Dollar",
"symbol": "$"
},
"asn": {
"as_number": "AS15169",
"organization": "Google LLC",
"country": "US"
},
"time_zone": {
"name": "America/Los_Angeles",
"offset": -8,
"offset_with_dst": -7,
"current_time": "2026-03-27 10:00:00.000-0700",
"current_time_unix": 1774630800.000,
"current_tz_abbreviation": "PDT",
"current_tz_full_name": "Pacific Daylight Time",
"standard_tz_abbreviation": "PST",
"standard_tz_full_name": "Pacific Standard Time",
"is_dst": true,
"dst_savings": 1,
"dst_exists": true,
"dst_tz_abbreviation": "PDT",
"dst_tz_full_name": "Pacific Daylight Time",
"dst_start": {
"utc_time": "2026-03-08 TIME 10:00",
"duration": "+1.00H",
"gap": true,
"date_time_after": "2026-03-08 TIME 03:00",
"date_time_before": "2026-03-08 TIME 02:00",
"overlap": false
},
"dst_end": {
"utc_time": "2026-11-01 TIME 09:00",
"duration": "-1.00H",
"gap": false,
"date_time_after": "2026-11-01 TIME 01:00",
"date_time_before": "2026-11-01 TIME 02:00",
"overlap": true
}
}
}2. Filtering Specific Fields from the Response
Use fields and excludes together to get the location object while omitting continent fields.
<script>
(async () => {
const ipGeoAPI = new IPGeolocationAPI({
fields: "location",
excludes: "location.continent_code,location.continent_name",
});
const resp = await ipGeoAPI.getGeolocation();
if (!resp.error_message) {
console.log(resp);
} else {
console.log("Something went wrong while fetching data", resp);
}
})();
</script>Sample Response:
{
"ip": "8.8.8.8",
"location": {
"country_code2": "US",
"country_code3": "USA",
"country_name": "United States",
"country_name_official": "United States of America",
"country_capital": "Washington, D.C.",
"state_prov": "California",
"state_code": "US-CA",
"district": "Santa Clara",
"city": "Mountain View",
"zipcode": "94043-1351",
"latitude": "37.42240",
"longitude": "-122.08421",
"is_eu": false,
"country_flag": "https://ipgeolocation.io/static/flags/us_64.png",
"geoname_id": "6301403",
"country_emoji": "🇺🇸"
}
}Paid Plan Examples
1. Geolocation with Default Fields
On a paid plan, the default response includes additional objects such as network, asn, company, and richer asn fields.
<script>
(async () => {
const ipGeoAPI = new IPGeolocationAPI();
const resp = await ipGeoAPI.getGeolocation();
if (!resp.error_message) {
console.log(resp);
} else {
console.log("Something went wrong while fetching data", resp);
}
})();
</script>Sample Response:
{
"ip": "8.8.8.8",
"location": {
"continent_code": "NA",
"continent_name": "North America",
"country_code2": "US",
"country_code3": "USA",
"country_name": "United States",
"country_name_official": "United States of America",
"country_capital": "Washington, D.C.",
"state_prov": "California",
"state_code": "US-CA",
"district": "Santa Clara",
"city": "Mountain View",
"zipcode": "94043-1351",
"latitude": "37.42240",
"longitude": "-122.08421",
"is_eu": false,
"country_flag": "https://ipgeolocation.io/static/flags/us_64.png",
"geoname_id": "6301403",
"country_emoji": "🇺🇸"
},
"country_metadata": {
"calling_code": "+1",
"tld": ".us",
"languages": ["en-US", "es-US", "haw", "fr"]
},
"network": {
"connection_type": "wired",
"route": "8.8.8.0/24",
"is_anycast": true
},
"currency": {
"code": "USD",
"name": "US Dollar",
"symbol": "$"
},
"asn": {
"as_number": "AS15169",
"organization": "Google LLC",
"country": "US",
"type": "HOSTING",
"domain": "about.google",
"date_allocated": "2000-03-30",
"rir": "ARIN"
},
"company": {
"name": "Google LLC",
"type": "HOSTING",
"domain": "google.com"
},
"time_zone": {
"name": "America/Los_Angeles",
"offset": -8,
"offset_with_dst": -7,
"current_time": "2026-03-27 10:00:00.000-0700",
"current_time_unix": 1774630800.000,
"current_tz_abbreviation": "PDT",
"current_tz_full_name": "Pacific Daylight Time",
"standard_tz_abbreviation": "PST",
"standard_tz_full_name": "Pacific Standard Time",
"is_dst": true,
"dst_savings": 1,
"dst_exists": true,
"dst_tz_abbreviation": "PDT",
"dst_tz_full_name": "Pacific Daylight Time",
"dst_start": {
"utc_time": "2026-03-08 TIME 10:00",
"duration": "+1.00H",
"gap": true,
"date_time_after": "2026-03-08 TIME 03:00",
"date_time_before": "2026-03-08 TIME 02:00",
"overlap": false
},
"dst_end": {
"utc_time": "2026-11-01 TIME 09:00",
"duration": "-1.00H",
"gap": false,
"date_time_after": "2026-11-01 TIME 01:00",
"date_time_before": "2026-11-01 TIME 02:00",
"overlap": true
}
}
}2. Retrieving Geolocation Data in Multiple Languages
Here is an example to get the geolocation data for the client's IP address in Russian (ru):
<script>
(async () => {
const ipGeoAPI = new IPGeolocationAPI({
lang: "ru",
});
const resp = await ipGeoAPI.getGeolocation();
if (!resp.error_message) {
console.log(resp);
} else {
console.log("Something went wrong while fetching data", resp);
}
})();
</script>3. Include Hostname and User-Agent
includeHostname, includeLiveHostname, and includeHostnameFallbackLive are available on paid plans. Use only one at a time.
<script>
(async () => {
const ipGeoAPI = new IPGeolocationAPI({
fields: "location.country_name,location.country_capital",
includeHostname: true,
includeUserAgent: true,
});
const resp = await ipGeoAPI.getGeolocation();
if (!resp.error_message) {
console.log(resp);
} else {
console.log("Something went wrong while fetching data", resp);
}
})();
</script>Sample Response:
{
"ip": "4.5.6.7",
"hostname": "4.5.6.7",
"location": {
"country_name": "United States",
"country_capital": "Washington, D.C."
},
"user_agent": {
"user_agent_string": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/143.0.0.0 Safari/537.36",
"name": "Chrome",
"type": "Browser",
"version": "143.0.0.0",
"version_major": "143",
"device": {
"name": "Linux Desktop",
"type": "Desktop",
"brand": "Unknown",
"cpu": "Intel x86_64"
},
"engine": {
"name": "Blink",
"type": "Browser",
"version": "143.0.0.0",
"version_major": "143"
},
"operating_system": {
"name": "Linux",
"type": "Desktop",
"version": "??",
"version_major": "??",
"build": "??"
}
}
}4. Include Geo Accuracy Fields
Pass includeGeoAccuracy: true to add accuracy_radius, confidence, and locality to the location object.
<script>
(async () => {
const ipGeoAPI = new IPGeolocationAPI({
fields: "location",
includeGeoAccuracy: true,
});
const resp = await ipGeoAPI.getGeolocation();
if (!resp.error_message) {
console.log(resp);
} else {
console.log("Something went wrong while fetching data", resp);
}
})();
</script>Sample Response (relevant location fields shown):
{
"ip": "91.128.103.196",
"location": {
"continent_code": "EU",
"continent_name": "Europe",
"country_code2": "SE",
"country_code3": "SWE",
"country_name": "Sweden",
"country_name_official": "Kingdom of Sweden",
"country_capital": "Stockholm",
"state_prov": "Stockholms län",
"state_code": "SE-AB",
"district": "Stockholm",
"city": "Stockholm",
"locality": "Stockholm",
"accuracy_radius": "9.148",
"confidence": "high",
"zipcode": "164 40",
"latitude": "59.40510",
"longitude": "17.95510",
"is_eu": true,
"country_flag": "https://ipgeolocation.io/static/flags/se_64.png",
"geoname_id": "9972319",
"country_emoji": "🇸🇪"
}
}5. Include DMA Code
The DMA (Designated Market Area) code is a US-only field used for marketing and regional targeting. Pass includeDmaCode: true to include it.
<script>
(async () => {
const ipGeoAPI = new IPGeolocationAPI({
fields: "location",
includeDmaCode: true,
});
const resp = await ipGeoAPI.getGeolocation();
if (!resp.error_message) {
console.log(resp);
} else {
console.log("Something went wrong while fetching data", resp);
}
})();
</script>Sample Response (US IP):
{
"ip": "107.161.145.197",
"location": {
"continent_code": "NA",
"continent_name": "North America",
"country_code2": "US",
"country_code3": "USA",
"country_name": "United States",
"country_name_official": "United States of America",
"country_capital": "Washington, D.C.",
"state_prov": "Pennsylvania",
"state_code": "US-PA",
"district": "Philadelphia County",
"city": "Philadelphia",
"dma_code": "504",
"zipcode": "19102",
"latitude": "39.95258",
"longitude": "-75.16522",
"is_eu": false,
"country_flag": "https://ipgeolocation.io/static/flags/us_64.png",
"geoname_id": "9849057",
"country_emoji": "🇺🇸"
}
}6. Include Abuse Contact Information
Pass includeAbuse: true to add the abuse object to the response.
<script>
(async () => {
const ipGeoAPI = new IPGeolocationAPI({
fields: "location.city,location.country_name",
includeAbuse: true,
});
const resp = await ipGeoAPI.getGeolocation();
if (!resp.error_message) {
console.log(resp);
} else {
console.log("Something went wrong while fetching data", resp);
}
})();
</script>Sample Response:
{
"ip": "91.128.103.196",
"location": {
"city": "Stockholm",
"country_name": "Sweden"
},
"abuse": {
"route": "91.128.0.0/14",
"country": "SE",
"name": "Swipnet Staff",
"organization": "",
"kind": "group",
"address": "Tele2 AB/Swedish IP Network\nIP Registry\nTorshamnsgatan 17 164 40 Kista SWEDEN",
"emails": ["abuse@tele2.com"],
"phone_numbers": ["+46 8 5626 42 10"]
}
}7. Include Security Information
Pass includeSecurity: true to add the security object to the geolocation response.
<script>
(async () => {
const ipGeoAPI = new IPGeolocationAPI({
fields: "location.city,location.country_name",
includeSecurity: true,
});
const resp = await ipGeoAPI.getGeolocation();
if (!resp.error_message) {
console.log(resp);
} else {
console.log("Something went wrong while fetching data", resp);
}
})();
</script>Sample Response:
{
"ip": "2.56.188.34",
"location": {
"city": "Dallas",
"country_name": "United States"
},
"security": {
"threat_score": 80,
"is_tor": false,
"is_proxy": true,
"proxy_provider_names": ["Zyte Proxy"],
"proxy_confidence_score": 80,
"proxy_last_seen": "2025-12-12",
"is_residential_proxy": true,
"is_vpn": true,
"vpn_provider_names": ["Nord VPN"],
"vpn_confidence_score": 80,
"vpn_last_seen": "2026-01-19",
"is_relay": false,
"relay_provider_name": "",
"is_anonymous": true,
"is_known_attacker": true,
"is_bot": false,
"is_spam": false,
"is_cloud_provider": true,
"cloud_provider_name": "Packethub S.A."
}
}8. Include All Optional Modules
Pass includeAll: true to request every available optional module (security, abuse, user_agent, hostname, geo_accuracy, dma_code) in a single call. Equivalent to passing include=* to the API.
<script>
(async () => {
const ipGeoAPI = new IPGeolocationAPI({
includeAll: true,
});
const resp = await ipGeoAPI.getGeolocation();
if (!resp.error_message) {
console.log(resp);
} else {
console.log("Something went wrong while fetching data", resp);
}
})();
</script>IPSecurityAPI Examples
The IPSecurityAPI class calls the dedicated /v3/security endpoint. getSecurity() returns the API response. By default, it includes ip and security. Use it when you need security data alone. To combine security data with geolocation, use IPGeolocationAPI with includeSecurity: true instead.
1. Basic Security Lookup
<script>
(async () => {
const ipSecAPI = new IPSecurityAPI({
ipAddress: "2.56.188.34",
});
const resp = await ipSecAPI.getSecurity();
if (!resp.error_message) {
console.log(resp);
} else {
console.log("Something went wrong while fetching data", resp);
}
})();
</script>Sample Response:
{
"ip": "2.56.188.34",
"security": {
"threat_score": 80,
"is_tor": false,
"is_proxy": true,
"proxy_provider_names": ["Zyte Proxy"],
"proxy_confidence_score": 80,
"proxy_last_seen": "2025-12-12",
"is_residential_proxy": true,
"is_vpn": true,
"vpn_provider_names": ["Nord VPN"],
"vpn_confidence_score": 80,
"vpn_last_seen": "2026-01-19",
"is_relay": false,
"relay_provider_name": "",
"is_anonymous": true,
"is_known_attacker": true,
"is_bot": false,
"is_spam": false,
"is_cloud_provider": true,
"cloud_provider_name": "Packethub S.A."
}
}2. Return Only Specific Security Fields
Use fields to limit the response to only the security properties you need.
<script>
(async () => {
const ipSecAPI = new IPSecurityAPI({
ipAddress: "2.56.188.34",
fields: "security.threat_score,security.is_vpn,security.is_proxy",
});
const resp = await ipSecAPI.getSecurity();
if (!resp.error_message) {
console.log(resp);
} else {
console.log("Something went wrong while fetching data", resp);
}
})();
</script>Sample Response:
{
"ip": "2.56.188.34",
"security": {
"threat_score": 80,
"is_proxy": true,
"is_vpn": true
}
}3. Exclude Specific Security Fields
Use excludes to return the full security object while omitting fields you don't need.
<script>
(async () => {
const ipSecAPI = new IPSecurityAPI({
ipAddress: "2.56.188.34",
excludes: "security.is_tor,security.is_cloud_provider",
});
const resp = await ipSecAPI.getSecurity();
if (!resp.error_message) {
console.log(resp);
} else {
console.log("Something went wrong while fetching data", resp);
}
})();
</script>Sample Response (is_tor and is_cloud_provider omitted):
{
"ip": "2.56.188.34",
"security": {
"threat_score": 80,
"is_proxy": true,
"proxy_provider_names": ["Zyte Proxy"],
"proxy_confidence_score": 80,
"proxy_last_seen": "2025-12-12",
"is_residential_proxy": true,
"is_vpn": true,
"vpn_provider_names": ["Nord VPN"],
"vpn_confidence_score": 80,
"vpn_last_seen": "2026-01-19",
"is_relay": false,
"relay_provider_name": "",
"is_anonymous": true,
"is_known_attacker": true,
"is_bot": false,
"is_spam": false,
"cloud_provider_name": "Packethub S.A."
}
}Error Handling
The plugin hides your API key when you print a client with JSON.stringify() or when an error message repeats it. You can still read the key from client.apiKey.
Inspect the error_message field in the response to detect any errors. A missing error_message typically indicates a successful request, while its presence signals an issue. For example, if you are using a free plan and trying to request security information, you will encounter an error as shown below:
Local testing only. Anyone who opens the page can read a key placed in it.
<script>
(async () => {
const ipGeoAPI = new IPGeolocationAPI({
apiKey: "YOUR_API_KEY",
includeSecurity: true,
});
const resp = await ipGeoAPI.getGeolocation();
if (!resp.error_message) {
console.log(resp);
} else {
console.log("Something went wrong while fetching data", resp);
}
})();
</script>Sample error response:
{
"error_message": "IP-hostname lookup, IP-security lookup and user-agent parsing are not supported on your free subscription. These features are available to all paid subscriptions only.",
"error_status": 401
}