Bestseller
IP Geolocation Location Services Network Analysis
IP Address Geolocation Lookup
Get geolocation information for any IP address including country, state, city, and coordinates. Supports both IPv4 and IPv6 addresses.
Data & API Features
Get geolocation information for any IP address (IPv4 and IPv6);
Retrieve country, state, city, and geographic coordinates;
Support for both IPv4 and IPv6 address formats;
Accurate location data from reliable geolocation databases;
Perfect for fraud detection, content localization, and analytics;
Real-time IP address validation and geolocation lookup;
Full API support for HTTPS (TLS v1.0 / v1.1 / v1.2 / v1.3);
Fully compatible with Apple ATS;
Nationwide multi-node CDN deployment;
Ultra-fast response, API interface load balancing built with multiple servers.
Annual Subscription
$49$99
Try it for free!
Sign In Sign in to get a trial key and test all APIs.
Secure payment by Stripe
API Document
HTTP Protocol:HTTPS
HTTP Method:GET
HTTP Endpoint:https://api.gugudata.io/v1/location/ip
Response Type:application/json; charset=utf-8
DEMO Endpoint:https://api.gugudata.io/v1/location/ip/demo
Live Demo:Try Interactive Demo
Full API Docs:developers.gugudata.io
API Request Parameters
| Name | Type | Is Required | Default Value | Remark |
|---|---|---|---|---|
| appkey | string | true | YOUR_APPKEY | Obtained after payment |
| ip | string | true | N/A | IP address to lookup (supports both IPv4 and IPv6, e.g., 8.8.8.8 or 2001:4878:b554:aaaa:aaaa:aaaa:aaaa:aaaa) |
API Response Parameters
| Name | Type | Remark |
|---|---|---|
| dataStatus.requestParameter | string | Echo of request parameters |
| dataStatus.statusCode | integer | HTTP status code of the response |
| dataStatus.status | string | Response status |
| dataStatus.statusDescription | string | Human-readable status message |
| dataStatus.responseDateTime | string | Server response timestamp |
| dataStatus.dataTotalCount | integer | Total number of records returned |
| data.countryCode | string | ISO country code (e.g., US, CN, GB) |
| data.state | string | State or province name |
| data.city | string | City name |
| data.latitude | number | Geographic latitude coordinate |
| data.longitude | number | Geographic longitude coordinate |
API Response Status Codes
| Status Code | Explanation of Status Code | Remarks |
|---|---|---|
| 200 | API responding normally | For business status codes, see below under API Custom Status Codes. |
| 400 | Parameter error | |
| 402 | APPKEY error | Please check if the APPKEY provided is the one obtained from the developer center. |
| 403 | Account overdue | Please pay attention to the E-mail reminders regarding order expiration. |
| 429 | Request rate limited | Requests cannot exceed 5 times per second. The CDN layer intelligently determines based on the frequency of IP requests. General high-frequency requests do not trigger this status code. |
| 500 | API response error |
