AGENTUTIL
DocsTools Reference

IP Geolocate

$0.01per call
ip.geolocate

Get geographic location and network info for an IP address

Endpoint
POST /v1/tools/ip.geolocate/tasks

Input

FieldTypeRequiredDescription
ipstringyesIPv4 or IPv6 address

Output

FieldTypeDescription
ipstring
citystring
regionstringRegion/state full name
region_codestringRegion/state code
countrystringCountry full name
country_codestringTwo-letter ISO country code
zipstring
latnumber
lngnumber
timezonestringIANA timezone (e.g. America/Los_Angeles)
ispstring
organizationstring
asstringAutonomous system number and name
is_mobileboolean
is_proxyboolean
is_hostingbooleanWhether the IP belongs to a hosting/datacenter provider

Example

Request
{
  "ip": "8.8.8.8"
}
Response
{
  "ip": "8.8.8.8",
  "city": "Mountain View",
  "region": "California",
  "region_code": "CA",
  "country": "United States",
  "country_code": "US",
  "zip": "94043",
  "lat": 37.4056,
  "lng": -122.0775,
  "timezone": "America/Los_Angeles",
  "isp": "Google LLC",
  "organization": "Google LLC",
  "as": "AS15169 Google LLC",
  "is_mobile": false,
  "is_proxy": false,
  "is_hosting": true
}