[DEMO] IP Address

IP Address Geolocation Lookup
Get geolocation information for any IP address including country, state, city, and coordinates. Supports both IPv4 and IPv6 addresses.

Method: GET
Path: /v1/location/ip
Demo: https://api.gugudata.io/v1/location/ip/demo

Request Parameters:

appkey (string, required): Obtained after payment

ip (string, required): IP address to lookup (supports both IPv4 and IPv6, e.g., 8.8.8.8 or 2001:4878:b554:aaaa:aaaa:aaaa:aaaa:aaaa)

Response Fields Count: 11
Response Field Examples:

dataStatus.requestParameter: Echo of request parameters

dataStatus.statusCode: HTTP status code of the response

dataStatus.status: Response status

dataStatus.statusDescription: Human-readable status message

dataStatus.responseDateTime: Server response timestamp

dataStatus.dataTotalCount: Total number of records returned

data.countryCode: ISO country code (e.g., US, CN, GB)

data.state: State or province name

... total 11 fields

Key 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

Details:
https://gugudata.io/details/location-ip

Responses

⚪0

application/json

Body

Example

{
  "dataStatus": {
    "requestParameter": "string",
    "statusCode": 0,
    "status": "string",
    "statusDescription": "string",
    "responseDateTime": "string",
    "dataTotalCount": 0
  },
  "data": {
    "countryCode": "string",
    "state": "string",
    "city": "string",
    "latitude": 0,
    "longitude": 0
  },
  "DataStatus": {
    "StatusCode": 100,
    "StatusDescription": "OK",
    "ResponseDateTime": "2026-01-01 00:00:00",
    "DataTotalCount": 1
  }
}

Request

Request Code Samples

Responses