UtilityActive

IP Geolocation

Resolve any IP address to country, city, ISP, and timezone. Fast, accurate, and requires no authentication.

Endpointx402 Payment Required

POST

https://agentsvc.io/api/v1/services/ip-lookup/call

Price

$0.001 USDC

Latency P99

~150ms

Provider

agentsvc.io

Input Schema

{
  "type": "object",
  "required": [
    "ip"
  ],
  "properties": {
    "ip": {
      "type": "string",
      "description": "IPv4 or IPv6 address to look up"
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Specific fields to return. Empty = all."
    }
  }
}

Output Schema

{
  "type": "object",
  "properties": {
    "ip": {
      "type": "string"
    },
    "country": {
      "type": "string"
    },
    "country_code": {
      "type": "string"
    },
    "region": {
      "type": "string"
    },
    "city": {
      "type": "string"
    },
    "postal": {
      "type": "string"
    },
    "lat": {
      "type": "number"
    },
    "lon": {
      "type": "number"
    },
    "timezone": {
      "type": "string"
    },
    "isp": {
      "type": "string"
    },
    "org": {
      "type": "string"
    },
    "asn": {
      "type": "string"
    },
    "is_vpn": {
      "type": "boolean"
    },
    "is_tor": {
      "type": "boolean"
    }
  }
}

Code Examples

curl -X POST "https://agentsvc.io/api/v1/services/ip-lookup/call" \
  -H "Content-Type: application/json" \
  -H "X-Payment: x402 usdc base <your-signed-payment>" \
  -d '{
  "url": "https://example.com"
}'

IP Geolocation

Input Schema

Output Schema

Code Examples

Tags

Service Info