Bestseller
IP Geolocation Log Enrichment Security Review

IP Geolocation and Log Enrichment API

Enrich public IP addresses with approximate location data

What can this API do?

IPv4 and IPv6 geolocation

Look up approximate country, region, city, latitude, and longitude for a public IPv4 or IPv6 address.

Application log enrichment

Add consistent location fields to access, authentication, support, and operational logs when coverage is available.

Traffic review context

Add approximate geographic context to traffic review and anomaly triage without treating it as precise device location.

Analytics segmentation

Group public network traffic by available country, region, or city fields for reporting and product analytics.

Dashboard-ready coordinates

Use nullable latitude and longitude fields in maps, dashboards, and location-aware operational views.

Predictable JSON integration

Integrate one stable response shape while handling valid public addresses that have no current location coverage.

IP Geolocation and Log Enrichment API
Annual plan
$49$99
Subscribe Annually Try Demo Request
Try it for free!
Sign in to get a trial key and test all APIs.
Sign In
Secure checkout powered 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

NameTypeIs RequiredDefault ValueRemark
appkeystringtrueYOUR_APPKEYApplication key used for request authentication.
ipstringtrue8.8.8.8Public IPv4 or IPv6 address to look up. Private, reserved, loopback, multicast, and malformed addresses are rejected.

API Response Parameters

NameTypeRemark
dataStatus.requestParameterstringPrivacy-safe request summary. IPv4 addresses are partially masked and IPv6 addresses are reduced to a /64 prefix.
dataStatus.statusCodeintegerApplication-level status code returned by the API.
dataStatus.statusstringApplication-level response status.
dataStatus.statusDescriptionstringHuman-readable status message
dataStatus.responseDateTimestringServer response timestamp in yyyy-MM-dd HH:mm:ss format.
dataStatus.dataTotalCountintegerNumber of geolocation records returned, either 0 or 1.
data.countryCodestringNullable ISO 3166-1 alpha-2 country code.
data.statestringNullable region, state, or province name.
data.citystringNullable city name.
data.latitudenumberNullable approximate latitude coordinate.
data.longitudenumberNullable approximate longitude coordinate.

API Response Status Codes

Status CodeExplanation of Status CodeRemarks
200Request processed successfully.Some endpoints expose a separate application-level status field in the response body, such as `dataStatus.statusCode`.
400Invalid request parameters or request format.Check required fields, data types, and request body format.
401Missing or unknown application key.Provide a valid `appkey` with the request.
403The application key is recognized but access is not allowed.The key may be expired, inactive, or not permitted for the requested API.
429Request rate or trial usage limit exceeded.Reduce concurrency or retry after the limit window resets.
500Internal service error.Retry later or contact support if the error persists.
503Upstream service unavailable.Retry later; the requested upstream dependency is temporarily unavailable.

Remote MCP

AI client access

Use this API through GuGuData Remote MCP

Connect your AI client once, authorize in the browser, and the client can use the GuGuData API tools available to your account. You do not need to paste an appkey into the MCP client.

Endpoint https://mcp.gugudata.io/mcp
Open MCP Guide
Generic MCP configuration
{
  "mcpServers": {
    "gugudata": {
      "url": "https://mcp.gugudata.io/mcp",
      "transportType": "streamable-http"
    }
  }
}

Code Snippets

Run in Apifox Run in Postman Open LLM Page

Related APIs

Useful APIs to extend this workflow.

View all APIs