IP Address Lookup

Look up geographic location information for an IP address using GeoLite2 database.

Endpoint: POST /biz/cloud/digital/ipaddress/lookup

Parameters

Parameter	Type	Required	Description
ip	String	Yes	IPv4 or IPv6 address

Request

curl -X POST "https://api.alaikis.com/std/biz/cloud/digital/ipaddress/lookup" \
  -H "X-API-Key: your_api_key" \
  -H "X-API-Secret: your_api_secret" \
  -d 'bizContent={"ip": "8.8.8.8"}'

Response

{
  "code": 200,
  "msg": "success",
  "data": {
    "ipAddress": "8.8.8.8",
    "countryCode": "US",
    "countryName": "United States",
    "regionCode": "CA",
    "regionName": "California",
    "city": "Mountain View",
    "postalCode": "94043",
    "latitude": 37.386,
    "longitude": -122.0838,
    "timezone": "America/Los_Angeles",
    "isp": "Google LLC"
  }
}

Data Model

Field	Type	Description
ipAddress	String	The queried IP address
countryCode	String	ISO 3166-1 alpha-2 country code
countryName	String	Full country name
regionCode	String	State/province code
regionName	String	State/province name
city	String	City name
postalCode	String	Postal/zip code
latitude	Double	Latitude in decimal degrees
longitude	Double	Longitude in decimal degrees
timezone	String	IANA timezone identifier
isp	String	Internet Service Provider name

Data Accuracy

Parameter	Accuracy
Country	99.5%
Region	95%
City	85% (urban areas)
Postal Code	80%
Coordinates	±50km radius

Data Source

IP geolocation data is powered by MaxMind GeoLite2 database, updated weekly.